*/ namespace Yasumi\Provider; use Yasumi\Exception\UnknownLocaleException; use Yasumi\Holiday; /** * Provider for all holidays in Canada. */ class Canada extends AbstractProvider { use CommonHolidays; use ChristianHolidays; /** * Code to identify this Holiday Provider. Typically, this is the ISO3166 code corresponding to the respective * country or sub-region. */ public const ID = 'CA'; /** * Initialize holidays for Canada. * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ public function initialize(): void { $this->timezone = 'America/Toronto'; // Add common holidays $this->addHoliday($this->newYearsDay($this->year, $this->timezone, $this->locale)); // Add Christian holidays $this->addHoliday($this->christmasDay($this->year, $this->timezone, $this->locale)); $this->addHoliday($this->secondChristmasDay($this->year, $this->timezone, $this->locale)); $this->addHoliday($this->goodFriday($this->year, $this->timezone, $this->locale)); $this->addHoliday($this->easterMonday($this->year, $this->timezone, $this->locale)); // Calculate other holidays $this->calculateCanadaDay(); $this->calculateLabourDay(); $this->calculateThanksgivingDay(); $this->calculateRemembranceDay(); $this->calculateNationalDayForTruthAndReconciliation(); } public function getSources(): array { return [ 'https://en.wikipedia.org/wiki/Public_holidays_in_Canada', ]; } /** * Family Day. * * @see https://en.wikipedia.org/wiki/Family_Day_(Canada) * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ protected function calculateFamilyDay(): void { if ($this->year < 2009) { return; } $this->addHoliday(new Holiday( 'familyDay', [], new \DateTime("third monday of february {$this->year}", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * Victoria Day. * * @see https://en.wikipedia.org/wiki/Victoria_Day * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ protected function calculateVictoriaDay(): void { if ($this->year < 1845) { return; } $this->addHoliday(new Holiday( 'victoriaDay', [], new \DateTime("last monday front of {$this->year}-05-25", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * National Indigenous Peoples Day. * * @see https://www.rcaanc-cirnac.gc.ca/eng/1100100013248/1534872397533 * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ protected function calculateNationalIndigenousPeoplesDay(): void { if ($this->year < 1996) { return; } $this->addHoliday(new Holiday( 'nationalIndigenousPeoplesDay', [], new \DateTime("{$this->year}-06-21", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * Civic Holiday. * * @see https://en.wikipedia.org/wiki/Civic_Holiday * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ protected function calculateCivicHoliday(): void { if ($this->year < 1879) { return; } $this->addHoliday(new Holiday( 'civicHoliday', [], new \DateTime("first monday of august {$this->year}", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * Canada Day. * * @see https://en.wikipedia.org/wiki/Canada_Day. * @see Holidays Act, R.S.C., 1985, c. H-5, https://laws-lois.justice.gc.ca/eng/acts/h-5/page-1.html * * by statute, Canada Day is July 1 if that day is not Sunday, and July 2 if July 1 is a Sunday. * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ private function calculateCanadaDay(): void { if ($this->year < 1983) { return; } $date = new \DateTime($this->year.'-07-01', DateTimeZoneFactory::getDateTimeZone($this->timezone)); if (7 === (int) $date->format('N')) { $date = new \DateTime($this->year.'-07-02', DateTimeZoneFactory::getDateTimeZone($this->timezone)); } $this->addHoliday(new Holiday( 'canadaDay', [], $date, $this->locale )); } /** * Thanksgiving. * * @see https://en.wikipedia.org/wiki/Thanksgiving_(Canada) * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ private function calculateThanksgivingDay(): void { if ($this->year < 1879) { return; } $this->addHoliday(new Holiday( 'thanksgivingDay', [], new \DateTime("second monday of october {$this->year}", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * Remembrance Day. * * @see https://en.wikipedia.org/wiki/Remembrance_Day_(Canada) * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ private function calculateRemembranceDay(): void { if ($this->year < 1919) { return; } $this->addHoliday(new Holiday( 'remembranceDay', [], new \DateTime("{$this->year}-11-11", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * Labour Day. * * @see https://en.wikipedia.org/wiki/Labour_Day * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ private function calculateLabourDay(): void { if ($this->year < 1894) { return; } $this->addHoliday(new Holiday( 'labourDay', [], new \DateTime("first monday of september {$this->year}", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } /** * National Day For Truth And Reconciliation. * * @see https://parl.ca/Content/Bills/432/Government/C-5/C-5_4/C-5_4.PDF, S. C. 2021, C.11. * * @throws \InvalidArgumentException * @throws UnknownLocaleException * @throws \Exception */ private function calculateNationalDayForTruthAndReconciliation(): void { if ($this->year < 2021) { return; } $this->addHoliday(new Holiday( 'truthAndReconciliationDay', [], new \DateTime("last day of september {$this->year}", DateTimeZoneFactory::getDateTimeZone($this->timezone)), $this->locale )); } }