feat(canada): Nunavut Day for the Nunavut province

Signed-off-by: Sacha Telgenhof <me@sachatelgenhof.com>

Author: stelgenhof

src/Yasumi/Provider/Canada/Nunavut.php

@@ -18,7 +18,9 @@
 namespace Yasumi\Provider\Canada;
 
 use Yasumi\Exception\UnknownLocaleException;
+use Yasumi\Holiday;
 use Yasumi\Provider\Canada;
+use Yasumi\Provider\DateTimeZoneFactory;
 
 /**
  * Provider for all holidays in Nunavut (Canada).
@@ -50,5 +52,32 @@ public function initialize(): void
 
         $this->calculateCivicHoliday();
         $this->calculateVictoriaDay();
+        $this->calculateNunavutDay();
+    }
+
+    /**
+     * Nunavut Day – July 9, originated as a paid holiday for Nunavut Tunngavik Incorporated
+     * and regional Inuit associations. It became a half-day holiday for government employees
+     * in 1999 and a full day in 2001.
+     *
+     * @see https://en.wikipedia.org/wiki/Nunavut_Day
+     *
+     * @throws \InvalidArgumentException
+     * @throws UnknownLocaleException
+     * @throws \Exception
+     */
+    protected function calculateNunavutDay(): void
+    {
+        if ($this->year < 1999) {
+            return;
+        }
+
+        $this->addHoliday(new Holiday(
+            'nunavutDay',
+            ['en' => 'Nunavut Day'],
+            new \DateTime("{$this->year}-07-09", DateTimeZoneFactory::getDateTimeZone($this->timezone)),
+            $this->locale,
+            Holiday::TYPE_OBSERVANCE
+        ));
     }
 }

tests/Canada/Nunavut/NunavutDayTest.php

@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types = 1);
+
+/**
+ * This file is part of the 'Yasumi' package.
+ *
+ * The easy PHP Library for calculating holidays.
+ *
+ * Copyright (c) 2015 - 2025 AzuyaLabs
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @author Sacha Telgenhof <me at sachatelgenhof dot com>
+ */
+
+namespace Yasumi\tests\Canada\Nunavut;
+
+use Yasumi\Holiday;
+use Yasumi\tests\HolidayTestCase;
+
+/*
+ * Nunavut Day – July 9, originated as a paid holiday for Nunavut Tunngavik Incorporated
+ * and regional Inuit associations. It became a half-day holiday for government employees
+ * in 1999 and a full day in 2001.
+ */
+class NunavutDayTest extends NunavutBaseTestCase implements HolidayTestCase
+{
+    public const HOLIDAY = 'nunavutDay';
+
+    public const ESTABLISHMENT_YEAR = 1999;
+
+    public function testNunavutDayOnAfterEstablishment(): void
+    {
+        $year = $this->generateRandomYear(self::ESTABLISHMENT_YEAR);
+        $this->assertHoliday(
+            self::REGION,
+            self::HOLIDAY,
+            $year,
+            new \DateTime("{$year}-07-09", new \DateTimeZone(self::TIMEZONE))
+        );
+    }
+
+    public function testLabourDayBeforeEstablishment(): void
+    {
+        $this->assertNotHoliday(
+            self::REGION,
+            self::HOLIDAY,
+            $this->generateRandomYear(1000, self::ESTABLISHMENT_YEAR - 1)
+        );
+    }
+
+    public function testTranslation(): void
+    {
+        $this->assertTranslatedHolidayName(
+            self::REGION,
+            self::HOLIDAY,
+            $this->generateRandomYear(self::ESTABLISHMENT_YEAR),
+            [self::LOCALE => 'Nunavut Day']
+        );
+    }
+
+    public function testHolidayType(): void
+    {
+        $this->assertHolidayType(
+            self::REGION,
+            self::HOLIDAY,
+            $this->generateRandomYear(self::ESTABLISHMENT_YEAR),
+            Holiday::TYPE_OBSERVANCE
+        );
+    }
+}

tests/Canada/Nunavut/NunavutTest.php

@@ -58,7 +58,12 @@ public function testOfficialHolidays(): void
      */
     public function testObservedHolidays(): void
     {
-        $this->assertDefinedHolidays([], self::REGION, $this->year, Holiday::TYPE_OBSERVANCE);
+        $holidays = [];
+
+        if ($this->year >= 1999) {
+            $holidays[] = 'nunavutDay';
+        }
+        $this->assertDefinedHolidays($holidays, self::REGION, $this->year, Holiday::TYPE_OBSERVANCE);
     }
 
     /**