date-holidays 3.33.0 → 3.34.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [3.34.0](https://github.com/commenthol/date-holidays/compare/3.33.0...3.34.0) (2026-07-26)
+
+- feat(KR): add substitute holiday (대체공휴일) support [a3270345](https://github.com/commenthol/date-holidays/commit/a3270345d0ffed64e51e928f0dc00b5fb0ffe2b5)
+- feat(US): add Frances Xavier Cabrini Day for Colorado [0ffbfcc1](https://github.com/commenthol/date-holidays/commit/0ffbfcc1ef50fbfd3cced8f4148d9db5cb3f2550)
+- fix(se): normalize names; fix himmelsfärdsdag typo [299db6aa](https://github.com/commenthol/date-holidays/commit/299db6aa33da7625b58df23a42abdd703c609d97)
+- test(ca): refresh holiday fixtures [8971459d](https://github.com/commenthol/date-holidays/commit/8971459de0c8e472cf26220e0bd518a74a3b75f2)
+- fix(ca): scope Thanksgiving by province [6232f7e4](https://github.com/commenthol/date-holidays/commit/6232f7e4727c4d23c86e66067122d1e2463d172b)
+- fix(ca): scope Victoria Day by province [284c321a](https://github.com/commenthol/date-holidays/commit/284c321a24d7728674ac3b482dfaff27a8b94c39)
+- fix(ca): remove national Easter Sunday [bb649d3c](https://github.com/commenthol/date-holidays/commit/bb649d3cd963e58a0e00f8b0083d2ccc10319337)
+- fix(ca): scope Remembrance Day by province [e2ce7b2d](https://github.com/commenthol/date-holidays/commit/e2ce7b2d62e960d12aaf1c5b0a9a3707287a23b8)
+- fix(ca): scope August holiday by province [4900d13e](https://github.com/commenthol/date-holidays/commit/4900d13efec54af1af796256db013f0a3cad272d)
+- fix(ca): scope Boxing Day to ON and NT [cf32e15b](https://github.com/commenthol/date-holidays/commit/cf32e15b2f49c98a119ce3f4232d437c5ab22511)
+- fix(ca): align provincial holiday overrides [d4eee9f2](https://github.com/commenthol/date-holidays/commit/d4eee9f20067382ef2614c6912398a13747f63d0)
+
 ## [3.33.0](https://github.com/commenthol/date-holidays/compare/3.32.0...3.33.0) (2026-07-11)
 
 - fix(BR): fix source for holiday in Espírito Santo [0c83b026](https://github.com/commenthol/date-holidays/commit/0c83b026ebaec5373de1c605f7dfeda4a9b8cb33)

package/data/countries/CA.yaml

@@ -57,15 +57,9 @@ holidays:
         type: observance
       easter -2:
         _name: easter -2
-      easter:
-        _name: easter
       2nd sunday after 05-01:
         _name: Mothers Day
         type: observance
-      monday before 05-25:
-        name:
-          en: Victoria Day
-          fr: Fête de la Reine
       3rd sunday after 06-01:
         _name: Fathers Day
         type: observance
@@ -73,10 +67,6 @@ holidays:
         name:
           en: Canada Day
           fr: Fête du Canada
-      1st monday in August:
-        name:
-          en: Civic Holiday
-          fr: Premier lundi d’août
       1st monday in September:
         _name: 05-01
       # @source https://www.canada.ca/en/canadian-heritage/campaigns/national-day-truth-reconciliation.html
@@ -87,23 +77,13 @@ holidays:
           fr: Journée nationale de la vérité et de la réconciliation
         type: observance
         note: Not a paid statutory holiday in all provinces and territories; Only federally-regulated employers governed by the Canada Labour Code are required to give their employees a paid day off work
-      2nd monday after 10-01:
-        name:
-          en: Thanksgiving
-          fr: Action de grâce
       10-31 18:00:
         name:
           en: Halloween
           fr: l'Halloween
         type: observance
-      11-11:
-        name:
-          en: Remembrance Day
-          fr: Jour du Souvenir
       12-25:
         _name: 12-25
-      12-26:
-        _name: 12-26
     states:
       AB:
         name: Alberta
@@ -114,6 +94,10 @@ holidays:
             name:
               en: Family Day
               fr: Fête de la famille
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
           easter 1:
             _name: easter 1
             type: optional
@@ -122,6 +106,14 @@ holidays:
               en: Heritage Day
               fr: Fête du patrimoine
             type: optional
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           09-30 since 2021: false
       BC:
         name: British Columbia
@@ -131,6 +123,21 @@ holidays:
           - America/Creston
           - America/Dawson_Creek
         days:
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
+          1st monday in August:
+            name:
+              en: British Columbia Day
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           2nd monday after 02-01:
             name:
               en: Family Day
@@ -154,10 +161,24 @@ holidays:
             name:
               en: Louis Riel Day
               fr: Journée Louis Riel
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
           1st monday in August:
             name:
               en: Terry Fox Day
               fr: Journée Terry Fox
+            type: optional
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
+            type: optional
       NB:
         name: New Brunswick
         zones:
@@ -167,6 +188,10 @@ holidays:
             name:
               en: New Brunswick Day
               fr: Jour de Nouveau Brunswick
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           # @attrib https://en.wikipedia.org/wiki/Family_Day_(Canada)
           3rd monday after 02-01:
             name:
@@ -181,6 +206,10 @@ holidays:
           - America/St_Johns
           - America/Goose_Bay
         days:
+          # @source https://www.assembly.nl.ca/legislation/sr/annualstatutes/RSN1990/S15.c90.htm
+          07-01:
+            name:
+              en: Memorial Day
           03-17:
             name:
               en: Saint Patrick's Day
@@ -201,6 +230,8 @@ holidays:
               en: Orangemen's Day
               fr: Fête des orangistes
             type: optional
+          # @source https://www.assembly.nl.ca/legislation/sr/annualstatutes/RSN1990/S15.c90.htm
+          1st monday in August: false
           11-11:
             name:
               en: Armistice Day
@@ -219,16 +250,45 @@ holidays:
             name:
               en: Natal Day
               fr: Jour de la Fondation
+            type: optional
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
       NT:
         name: Northwest Territories
         zones:
           - America/Yellowknife
           - America/Inuvik
         days:
+          1st monday in August:
+            name:
+              en: Civic Holiday
+              fr: Premier lundi d’août
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
+          # @source https://my.hr.gov.nt.ca/employees/leave-time/statutory-holidays
+          easter: false
+          # @source https://my.hr.gov.nt.ca/employees/leave-time/statutory-holidays
+          easter 1:
+            _name: easter 1
           06-21 since 2001:
             name:
               en: National Indigenous Peoples Day
               fr: Journée nationale des Autochthones
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          # @source https://my.hr.gov.nt.ca/employees/leave-time/statutory-holidays
+          12-26:
+            _name: 12-26
       NU:
         name: Nunavut
         zones:
@@ -239,10 +299,26 @@ holidays:
           - America/Atikokan
           - America/Cambridge_Bay
         days:
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
+          1st monday in August:
+            name:
+              en: Civic Holiday
+              fr: Premier lundi d’août
           07-09:
             name:
               en: Nunavut Day
             type: bank
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           09-30 since 2021: false
       "ON":
         name: Ontario
@@ -258,8 +334,29 @@ holidays:
             name:
               en: Family Day
               fr: Fête de la famille
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
           easter 1:
             _name: easter 1
+          1st monday in August:
+            name:
+              en: Civic Holiday
+              fr: Premier lundi d’août
+            type: optional
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
+            type: optional
+          # @source https://www.ontario.ca/document/your-guide-employment-standards-act-0/public-holidays
+          12-26:
+            _name: 12-26
           09-30 since 2021: false
       PE:
         name: Prince Edward Island
@@ -275,6 +372,10 @@ holidays:
             name:
               en: Gold Cup Parade Day
               fr: "Défilé de la Coupe d'or"
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           09-30 since 2021: false
       # @source https://www.cnesst.gouv.qc.ca/en/working-conditions/leave/statutory-holidays/statutory-holidays
       QC:
@@ -287,9 +388,12 @@ holidays:
           easter -2:
             _name: easter -2
             note: Either Good Friday or Easter Monday, at the employer’s option
+          # @source https://www.cnesst.gouv.qc.ca/en/working-conditions/leave/statutory-holidays/statutory-holidays
           easter 1:
             _name: easter 1
+            type: optional
             note: Either Good Friday or Easter Monday, at the employer’s option
+          # @source https://www.cnesst.gouv.qc.ca/en/working-conditions/leave/statutory-holidays/statutory-holidays
           monday before 05-25:
             name:
               en: National Patriots' Day
@@ -298,7 +402,14 @@ holidays:
             name:
               en: National Holiday
               fr: Fête nationale du Québec
-          monday after 08-01: false
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          # @source https://www.cnesst.gouv.qc.ca/en/working-conditions/leave/statutory-holidays/statutory-holidays
+          11-11: false
+          # @source https://www.cnesst.gouv.qc.ca/en/working-conditions/leave/statutory-holidays/statutory-holidays
+          12-26: false
           09-30 since 2021: false
       SK:
         name: Saskatchewan
@@ -311,9 +422,21 @@ holidays:
             name:
               en: Family Day
               fr: Fête de la famille
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
           1st monday in August:
             name:
               en: Saskatchewan Day
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           09-30 since 2021: false
       YT:
         name: Yukon
@@ -323,10 +446,22 @@ holidays:
         days:
           easter 1:
             _name: easter 1
+          monday before 05-25:
+            name:
+              en: Victoria Day
+              fr: Fête de la Reine
+          11-11:
+            name:
+              en: Remembrance Day
+              fr: Jour du Souvenir
           3rd monday in August:
             name:
               en: Discovery Day
               fr: Jour de la Découverte
+          2nd monday after 10-01:
+            name:
+              en: Thanksgiving
+              fr: Action de grâce
           06-21 since 2017:
             name:
               en: National Indigenous Peoples Day

package/data/countries/KR.yaml

@@ -21,14 +21,35 @@ holidays:
         name:
           en: Independence Movement Day
           ko: 3·1절
+      substitutes 03-01 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: Independence Movement Day
+          ko: 3·1절
+        active:
+          - from: "2021-01-01"
       05-05:
         name:
           en: Children's Day
           ko: 어린이날
+      substitutes 05-05 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: Children's Day
+          ko: 어린이날
+        active:
+          - from: "2014-01-01"
       korean 4-0-8:
         name:
           en: Buddha's Birthday
           ko: 석가탄신일
+      substitutes korean 4-0-8 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: Buddha's Birthday
+          ko: 석가탄신일
+        active:
+          - from: "2023-01-01"
       06-06:
         name:
           en: Memorial Day
@@ -43,10 +64,24 @@ holidays:
         name:
           en: Constitution Day
           ko: 제헌절
+      substitutes 07-17 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: Constitution Day
+          ko: 제헌절
+        active:
+          - from: "2026-01-01"
       08-15:
         name:
           en: Liberation Day
           ko: 광복절
+      substitutes 08-15 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: Liberation Day
+          ko: 광복절
+        active:
+          - from: "2021-01-01"
       korean 8-0-14 P3D:
         name:
           en: Korean Thanksgiving
@@ -55,12 +90,261 @@ holidays:
         name:
           en: National Foundation Day
           ko: 개천절
+      substitutes 10-03 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: National Foundation Day
+          ko: 개천절
+        active:
+          - from: "2021-01-01"
       10-09:
         name:
           en: Hangul Day
           ko: 한글날
+      substitutes 10-09 if Saturday,Sunday then next Monday:
+        substitute: true
+        name:
+          en: Hangul Day
+          ko: 한글날
+        active:
+          - from: "2021-01-01"
       12-25:
         _name: 12-25
+      substitutes 12-25 if Saturday,Sunday then next Monday:
+        _name: 12-25
+        substitute: true
+        active:
+          - from: "2023-01-01"
+      # Seollal substitute holidays (Sunday overlap, or overlap with another public
+      # holiday on a weekday) can't use the generic weekend-substitute pattern above:
+      # the underlying `korean 01-0-01 P3D` 3-day span is anchored at 당일 (1st lunar
+      # day) instead of 전날, so it omits 전날 and includes an extra day past 다음날 --
+      # a rule keyed off that span would trigger on the wrong day. Anchored here at the
+      # real (corrected) 전날/당일/다음날 dates instead, computed per year. Chuseok is
+      # anchored correctly already (`korean 8-0-14` = the day before Chuseok) but still
+      # needs explicit entries below for the rare cases where it overlaps another
+      # holiday. Covers 2014-2050; needs extending past that.
+      # @source https://github.com/commenthol/date-holidays/issues/640
+      "substitutes 2014-09-07 if Sunday then next Wednesday": # -> 2014-09-10
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2015-09-27 if Sunday then next Tuesday": # -> 2015-09-29
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2016-02-07 if Sunday then next Wednesday": # -> 2016-02-10
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2017-01-29 if Sunday then next Monday": # -> 2017-01-30
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2017-10-03 if Tuesday then next Friday": # -> 2017-10-06
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2018-09-23 if Sunday then next Wednesday": # -> 2018-09-26
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2020-01-26 if Sunday then next Monday": # -> 2020-01-27
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2022-09-11 if Sunday then next Monday": # -> 2022-09-12
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2023-01-22 if Sunday then next Tuesday": # -> 2023-01-24
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2024-02-11 if Sunday then next Monday": # -> 2024-02-12
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2025-05-05 if Monday then next Tuesday": # -> 2025-05-06
+        substitute: true
+        name:
+          en: Children's Day
+          ko: 어린이날
+      "substitutes 2025-05-05 if Monday then next Tuesday #1": # -> 2025-05-06
+        substitute: true
+        name:
+          en: Buddha's Birthday
+          ko: 석가탄신일
+      "substitutes 2025-10-05 if Sunday then next Wednesday": # -> 2025-10-08
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2027-02-07 if Sunday then next Tuesday": # -> 2027-02-09
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2028-10-03 if Tuesday then next Thursday": # -> 2028-10-05
+        substitute: true
+        name:
+          en: National Foundation Day
+          ko: 개천절
+      "substitutes 2028-10-03 if Tuesday then next Thursday #1": # -> 2028-10-05
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2029-09-23 if Sunday then next Monday": # -> 2029-09-24
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2030-02-03 if Sunday then next Tuesday": # -> 2030-02-05
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2032-09-19 if Sunday then next Tuesday": # -> 2032-09-21
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2033-01-30 if Sunday then next Wednesday": # -> 2033-02-02
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2034-02-19 if Sunday then next Tuesday": # -> 2034-02-21
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2035-09-16 if Sunday then next Tuesday": # -> 2035-09-18
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2036-01-27 if Sunday then next Wednesday": # -> 2036-01-30
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2036-10-03 if Friday then next Monday": # -> 2036-10-06
+        substitute: true
+        name:
+          en: National Foundation Day
+          ko: 개천절
+      "substitutes 2036-10-03 if Friday then next Monday #1": # -> 2036-10-06
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2036-10-05 if Sunday then next Tuesday": # -> 2036-10-07
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2037-02-15 if Sunday then next Tuesday": # -> 2037-02-17
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2038-09-12 if Sunday then next Wednesday": # -> 2038-09-15
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2039-01-23 if Sunday then next Wednesday": # -> 2039-01-26
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2039-10-02 if Sunday then next Tuesday": # -> 2039-10-04
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2039-10-03 if Monday then next Wednesday": # -> 2039-10-05
+        substitute: true
+        name:
+          en: National Foundation Day
+          ko: 개천절
+      "substitutes 2039-10-03 if Monday then next Wednesday #1": # -> 2039-10-05
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2040-02-12 if Sunday then next Tuesday": # -> 2040-02-14
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2042-09-28 if Sunday then next Tuesday": # -> 2042-09-30
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2044-01-31 if Sunday then next Monday": # -> 2044-02-01
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2044-05-05 if Thursday then next Friday": # -> 2044-05-06
+        substitute: true
+        name:
+          en: Children's Day
+          ko: 어린이날
+      "substitutes 2044-05-05 if Thursday then next Friday #1": # -> 2044-05-06
+        substitute: true
+        name:
+          en: Buddha's Birthday
+          ko: 석가탄신일
+      "substitutes 2045-09-24 if Sunday then next Wednesday": # -> 2045-09-27
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2046-09-16 if Sunday then next Monday": # -> 2046-09-17
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2047-01-27 if Sunday then next Monday": # -> 2047-01-28
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
+      "substitutes 2047-10-03 if Thursday then next Monday": # -> 2047-10-07
+        substitute: true
+        name:
+          en: National Foundation Day
+          ko: 개천절
+      "substitutes 2047-10-03 if Thursday then next Monday #1": # -> 2047-10-07
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2049-09-12 if Sunday then next Monday": # -> 2049-09-13
+        substitute: true
+        name:
+          en: Korean Thanksgiving
+          ko: 추석
+      "substitutes 2050-01-23 if Sunday then next Tuesday": # -> 2050-01-25
+        substitute: true
+        name:
+          en: Korean New Year
+          ko: 설날
     # states:
     #   11:
     #     name: Seoul

package/data/countries/SE.yaml

@@ -1,4 +1,5 @@
 holidays:
+  # @source https://www.riksdagen.se/sv/dokument-och-lagar/dokument/svensk-forfattningssamling/lag-1989253-om-allmanna-helgdagar_sfs-1989-253/
   # @attrib https://de.wikipedia.org/wiki/Feiertage_in_Schweden
   # @attrib https://sv.wikipedia.org/wiki/Helgdagar_i_Sverige
   SE:
@@ -74,11 +75,11 @@ holidays:
       # @attrib https://sv.wikipedia.org/wiki/Sveriges_nationaldag#Svenska_flaggans_dag
       06-06 since 2005:
         name:
-          sv: Sveriges nationaldag
+          sv: nationaldagen
           en: National Day
       06-06 since 1983 prior to 2005:
         name:
-          sv: Sveriges nationaldag
+          sv: nationaldagen
           en: National Day
         type: observance
       friday after 06-19: