Add new US federal holiday Juneteenth National Independence Day. (#253)

CHANGELOG.md

@@ -8,6 +8,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/) and this
 
 ### Added
 
+- Added new Juneteenth National Independence Day to USA [\#253](https://github.com/azuyalabs/yasumi/pull/253) ([Mark Heintz](https://github.com/mheintz))
+
+
 ### Changed
 
 ### Fixed

src/Yasumi/Provider/USA.php

@@ -57,6 +57,7 @@ public function initialize(): void
         $this->calculateMartinLutherKingday();
         $this->calculateWashingtonsBirthday();
         $this->calculateMemorialDay();
+        $this->calculateJuneteenth();
         $this->calculateIndependenceDay();
         $this->calculateLabourDay();
         $this->calculateColumbusDay();
@@ -138,6 +139,27 @@ private function calculateMemorialDay(): void
         }
     }
 
+    /**
+     * Juneteenth National Independence Day.
+     *
+     * Juneteenth National Independence Day, commonly known simply as Juneteenth, is a federal holiday in the United
+     * States commemorating the end of slavery. Established as a federal holiday on June 17, 2021, Juneteenth is
+     * celebrated annually on June 19. In case Juneteenth falls on a Sunday, a substituted holiday is observed
+     * the following Monday. If it falls on a Saturday, a substituted holiday is observed the previous Friday.
+     *
+     * @see https://en.wikipedia.org/wiki/Juneteenth
+     *
+     * @throws \Exception
+     */
+    private function calculateJuneteenth(): void
+    {
+        if ($this->year >= 2021) {
+            $this->addHoliday(new Holiday('juneteenth', [
+                'en' => 'Juneteenth',
+            ], new DateTime("$this->year-6-19", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale));
+        }
+    }
+
     /**
      * Independence Day.
      *

tests/USA/JuneteenthTest.php

@@ -0,0 +1,133 @@
+<?php
+
+declare(strict_types=1);
+/*
+ * This file is part of the Yasumi package.
+ *
+ * Copyright (c) 2015 - 2021 AzuyaLabs
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @author Sacha Telgenhof <[email protected]>
+ */
+
+namespace Yasumi\tests\USA;
+
+use DateTime;
+use DateTimeZone;
+use Exception;
+use ReflectionException;
+use Yasumi\Holiday;
+use Yasumi\tests\YasumiTestCaseInterface;
+
+/**
+ * Class to test Juneteenth.
+ */
+class JuneteenthTest extends USABaseTestCase implements YasumiTestCaseInterface
+{
+    /**
+     * The name of the holiday.
+     */
+    public const HOLIDAY = 'juneteenth';
+
+    /**
+     * The year in which the holiday was first established.
+     */
+    public const ESTABLISHMENT_YEAR = 2021;
+
+    /**
+     * Tests Juneteenth on or after 2021. Juneteenth is celebrated since 2021 on June 19th.
+     *
+     * @throws Exception
+     * @throws ReflectionException
+     */
+    public function testJuneteenthOnAfter2021(): void
+    {
+        $year = 2023;
+        $this->assertHoliday(
+            self::REGION,
+            self::HOLIDAY,
+            $year,
+            new DateTime("$year-6-19", new DateTimeZone(self::TIMEZONE))
+        );
+    }
+
+    /**
+     * Tests Juneteenth on or after 2021 when substituted on Monday (when Juneteenth falls on Sunday).
+     *
+     * @throws Exception
+     * @throws ReflectionException
+     */
+    public function testJuneteenthOnAfter2021SubstitutedMonday(): void
+    {
+        $year = 2022;
+        $this->assertHoliday(
+            self::REGION,
+            'substituteHoliday:juneteenth',
+            $year,
+            new DateTime("$year-6-20", new DateTimeZone(self::TIMEZONE))
+        );
+    }
+
+    /**
+     * Tests Juneteenth on or after 2021 when substituted on Friday (when Juneteenth falls on Saturday).
+     *
+     * @throws Exception
+     * @throws ReflectionException
+     */
+    public function testJuneteenthOnAfter2021SubstitutedFriday(): void
+    {
+        $year = 2021;
+        $this->assertHoliday(
+            self::REGION,
+            'substituteHoliday:juneteenth',
+            $year,
+            new DateTime("$year-6-18", new DateTimeZone(self::TIMEZONE))
+        );
+    }
+
+    /**
+     * Tests Juneteenth before 2021. Juneteenth is celebrated since 2021 on June 19th.
+     *
+     * @throws ReflectionException
+     */
+    public function testJuneteenthBefore2021(): void
+    {
+        $this->assertNotHoliday(
+            self::REGION,
+            self::HOLIDAY,
+            $this->generateRandomYear(1000, self::ESTABLISHMENT_YEAR - 1)
+        );
+    }
+
+    /**
+     * Tests translated name of the holiday defined in this test.
+     *
+     * @throws ReflectionException
+     */
+    public function testTranslation(): void
+    {
+        $this->assertTranslatedHolidayName(
+            self::REGION,
+            self::HOLIDAY,
+            $this->generateRandomYear(self::ESTABLISHMENT_YEAR),
+            [self::LOCALE => 'Juneteenth']
+        );
+    }
+
+    /**
+     * Tests type of the holiday defined in this test.
+     *
+     * @throws ReflectionException
+     */
+    public function testHolidayType(): void
+    {
+        $this->assertHolidayType(
+            self::REGION,
+            self::HOLIDAY,
+            $this->generateRandomYear(self::ESTABLISHMENT_YEAR),
+            Holiday::TYPE_OFFICIAL
+        );
+    }
+}

tests/USA/USATest.php

@@ -47,6 +47,7 @@ public function testOfficialHolidays(): void
             'martinLutherKingDay',
             'washingtonsBirthday',
             'memorialDay',
+            'juneteenth',
             'independenceDay',
             'labourDay',
             'columbusDay',