Added support for Ukrainian language (uk)

README.md

@@ -35,6 +35,10 @@ Serhii\Ago\Lang::set('ru');
       <td>Russian</td>
       <td>ru</td>
     </tr>
+    <tr>
+      <td>Ukrainian</td>
+      <td>uk</td>
+    </tr>
   </tbody>
 </table>
 

resources/lang/uk.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+return [
+
+    'ago' => 'назад',
+    'online' => 'В мережі', // Uppercase first letter
+    // Seconds
+    'second' => 'секунда',
+    'seconds' => 'секунди',
+    'seconds-special' => 'секунд',
+    // Minutes
+    'minute' => 'хвилина',
+    'minutes' => 'хвилини',
+    'minutes-special' => 'хвилин',
+    // Hours
+    'hour' => 'година',
+    'hours' => 'години',
+    'hours-special' => 'годин',
+    // Days
+    'day' => 'день',
+    'days' => 'дня',
+    'days-special' => 'днів',
+    // Weeks
+    'week' => 'тиждень',
+    'weeks' => 'тижні',
+    'weeks-special' => 'тижнів',
+    // Months
+    'month' => 'місяць',
+    'months' => 'місяці',
+    'months-special' => 'місяців',
+    // Years
+    'year' => 'рік',
+    'years' => 'року',
+    'years-special' => 'років',
+
+];

resources/rules/uk.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * @param int $number The number that represents seconds, minutes, hours, days, weeks, months and years.
+ * If input is 1 year, this number will be 1, if input is 5 minutes this number will be 5.
+ * @param int $last_digit Last digit of the number. For example 23 will be 3, 2 will be 2, 60 will be 0.
+ *
+ * @return bool[]|array[]
+ */
+return static function (int $number, int $last_digit): array {
+    return [
+        'single' => [
+            $number === 1,
+            $last_digit === 1 && $number >= 21,
+        ],
+        'plural' => [
+            $number >= 2 && $number < 5,
+            $number >= 22 && $last_digit >= 2 && $last_digit < 5,
+        ],
+        'special' => [
+            $number >= 5 && $number <= 20,
+            $last_digit === 0,
+            $last_digit >= 5 && $last_digit <= 9,
+        ],
+    ];
+};

tests/Translations/UkrainianTest.php

@@ -0,0 +1,142 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Serhii\Tests\Translations;
+
+use Carbon\CarbonImmutable;
+use PHPUnit\Framework\TestCase;
+use Serhii\Ago\Lang;
+use Serhii\Ago\TimeAgo;
+
+class UkrainianTest extends TestCase
+{
+    private $language = 'uk';
+
+    /**
+     * @dataProvider provider_for_returns_correct_time_from_one_minute_and_above
+     * @test
+     *
+     * @param string $method
+     * @param int $time
+     * @param string $output_expected
+     *
+     * @throws \Exception
+     */
+    public function returns_correct_time_from_one_minute_and_above(string $method, int $time, string $output_expected): void
+    {
+        Lang::set($this->language);
+        $date = CarbonImmutable::now()->{$method}($time)->toDateTimeString();
+        $this->assertSame($output_expected, TimeAgo::trans($date));
+    }
+
+    public function provider_for_returns_correct_time_from_one_minute_and_above(): array
+    {
+        return [
+            ['subSeconds', 60, '1 хвилина назад'],
+            ['subMinutes', 1, '1 хвилина назад'],
+            ['subMinutes', 2, '2 хвилини назад'],
+            ['subMinutes', 3, '3 хвилини назад'],
+            ['subMinutes', 4, '4 хвилини назад'],
+            ['subMinutes', 5, '5 хвилин назад'],
+            ['subMinutes', 6, '6 хвилин назад'],
+            ['subMinutes', 7, '7 хвилин назад'],
+            ['subMinutes', 8, '8 хвилин назад'],
+            ['subMinutes', 9, '9 хвилин назад'],
+            ['subMinutes', 10, '10 хвилин назад'],
+            ['subMinutes', 11, '11 хвилин назад'],
+            ['subMinutes', 12, '12 хвилин назад'],
+            ['subMinutes', 13, '13 хвилин назад'],
+            ['subMinutes', 59, '59 хвилин назад'],
+            ['subMinutes', 60, '1 година назад'],
+            ['subHours', 1, '1 година назад'],
+            ['subHours', 2, '2 години назад'],
+            ['subHours', 3, '3 години назад'],
+            ['subHours', 4, '4 години назад'],
+            ['subHours', 5, '5 годин назад'],
+            ['subHours', 6, '6 годин назад'],
+            ['subHours', 7, '7 годин назад'],
+            ['subHours', 8, '8 годин назад'],
+            ['subHours', 9, '9 годин назад'],
+            ['subHours', 10, '10 годин назад'],
+            ['subHours', 11, '11 годин назад'],
+            ['subHours', 12, '12 годин назад'],
+            ['subHours', 13, '13 годин назад'],
+            ['subHours', 14, '14 годин назад'],
+            ['subHours', 15, '15 годин назад'],
+            ['subHours', 16, '16 годин назад'],
+            ['subHours', 17, '17 годин назад'],
+            ['subHours', 18, '18 годин назад'],
+            ['subHours', 19, '19 годин назад'],
+            ['subHours', 20, '20 годин назад'],
+            ['subHours', 21, '21 година назад'],
+            ['subHours', 22, '22 години назад'],
+            ['subHours', 23, '23 години назад'],
+            ['subHours', 24, '1 день назад'],
+            ['subDays', 5, '5 днів назад'],
+            ['subDays', 2, '2 дня назад'],
+            ['subDays', 7, '1 тиждень назад'],
+            ['subWeeks', 2, '2 тижні назад'],
+            ['subMonths', 1, '1 місяць назад'],
+            ['subMonths', 2, '2 місяці назад'],
+            ['subMonths', 11, '11 місяців назад'],
+            ['subMonths', 12, '1 рік назад'],
+            ['subYears', 5, '5 років назад'],
+            ['subYears', 21, '21 рік назад'],
+            ['subYears', 30, '30 років назад'],
+            ['subYears', 31, '31 рік назад'],
+            ['subYears', 41, '41 рік назад'],
+            ['subYears', 100, '100 років назад'],
+            ['subYears', 101, '101 рік назад'],
+        ];
+    }
+
+    /**
+     * @dataProvider provider_for_returns_correct_date_from_0_seconds_to_59_seconds
+     * @test
+     *
+     * @param int $seconds
+     * @param array $expect
+     *
+     * @throws \Exception
+     */
+    public function returns_correct_date_from_0_seconds_to_59_seconds(int $seconds, array $expect): void
+    {
+        Lang::set($this->language);
+
+        $date = CarbonImmutable::now()->subSeconds($seconds)->toDateTimeString();
+        $message = sprintf("Expected '%s' or '%s' but got '%s'", $expect[0], $expect[1], $res = TimeAgo::trans($date));
+        $this->assertContains($res, $expect, $message);
+    }
+
+    public function provider_for_returns_correct_date_from_0_seconds_to_59_seconds(): array
+    {
+        return [
+            [0, ['0 секунд назад', '1 секунда назад']],
+            [1, ['1 секунда назад', '2 секунди назад']],
+            [2, ['2 секунди назад', '3 секунди назад']],
+            [3, ['3 секунди назад', '4 секунди назад']],
+            [4, ['4 секунди назад', '5 секунд назад']],
+            [5, ['5 секунд назад', '6 секунд назад']],
+            [6, ['6 секунд назад', '7 секунд назад']],
+            [7, ['7 секунд назад', '8 секунд назад']],
+            [8, ['8 секунд назад', '9 секунд назад']],
+            [9, ['9 секунд назад', '10 секунд назад']],
+            [10, ['10 секунд назад', '11 секунд назад']],
+            [11, ['11 секунд назад', '12 секунд назад']],
+            [12, ['12 секунд назад', '13 секунд назад']],
+            [13, ['13 секунд назад', '14 секунд назад']],
+            [14, ['14 секунд назад', '15 секунд назад']],
+            [15, ['15 секунд назад', '16 секунд назад']],
+            [16, ['16 секунд назад', '17 секунд назад']],
+            [17, ['17 секунд назад', '18 секунд назад']],
+            [18, ['18 секунд назад', '19 секунд назад']],
+            [19, ['19 секунд назад', '20 секунд назад']],
+            [20, ['20 секунд назад', '21 секунда назад']],
+            [21, ['21 секунда назад', '22 секунди назад']],
+            [41, ['41 секунда назад', '42 секунди назад']],
+            [54, ['54 секунди назад', '55 секунд назад']],
+            [58, ['58 секунд назад', '59 секунд назад']],
+        ];
+    }
+}