holidays 0.55__py3-none-any.whl → 0.57__py3-none-any.whl

holidays/countries/austria.py

@@ -107,7 +107,7 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Christmas Day.
         self._add_christmas_day(tr("Christtag"))
 
-        # St. Stephen's Day.
+        # Saint Stephen's Day.
         self._add_christmas_day_two(tr("Stefanitag"))
 
     def _populate_bank_holidays(self):
@@ -121,43 +121,43 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_new_years_eve(tr("Silvester"))
 
     def _populate_subdiv_1_bank_holidays(self):
-        # St. Martin's Day.
+        # Saint Martin's Day.
         self._add_holiday_nov_11(tr("Hl. Martin"))
 
     def _populate_subdiv_2_bank_holidays(self):
-        # St. Joseph's Day.
+        # Saint Joseph's Day.
         self._add_saint_josephs_day(tr("Hl. Josef"))
 
         # 1920 Carinthian plebiscite.
         self._add_holiday_oct_10(tr("Tag der Volksabstimmung"))
 
     def _populate_subdiv_3_bank_holidays(self):
-        # St. Leopold's Day.
+        # Saint Leopold's Day.
         self._add_holiday_nov_15(tr("Hl. Leopold"))
 
     def _populate_subdiv_4_bank_holidays(self):
         if self._year >= 2004:
-            # St. Florian's Day.
+            # Saint Florian's Day.
             self._add_holiday_may_4(tr("Hl. Florian"))
 
     def _populate_subdiv_5_bank_holidays(self):
-        # St. Rupert's Day.
+        # Saint Rupert's Day.
         self._add_holiday_sep_24(tr("Hl. Rupert"))
 
     def _populate_subdiv_6_bank_holidays(self):
-        # St. Joseph's Day.
+        # Saint Joseph's Day.
         self._add_saint_josephs_day(tr("Hl. Josef"))
 
     def _populate_subdiv_7_bank_holidays(self):
-        # St. Joseph's Day.
+        # Saint Joseph's Day.
         self._add_saint_josephs_day(tr("Hl. Josef"))
 
     def _populate_subdiv_8_bank_holidays(self):
-        # St. Joseph's Day.
+        # Saint Joseph's Day.
         self._add_saint_josephs_day(tr("Hl. Josef"))
 
     def _populate_subdiv_9_bank_holidays(self):
-        # St. Leopold's Day.
+        # Saint Leopold's Day.
         self._add_holiday_nov_15(tr("Hl. Leopold"))
 
 

holidays/countries/bahrain.py

@@ -46,16 +46,16 @@ class Bahrain(HolidayBase, InternationalHolidays, IslamicHolidays):
         # Labor Day.
         self._add_labor_day(tr("عيد العمال"))
 
-        # Eid Al Fitr.
+        # Eid al-Fitr.
         eid_al_fitr = tr("عيد الفطر")
         self._add_eid_al_fitr_day(eid_al_fitr)
         self._add_eid_al_fitr_day_two(tr("عطلة عيد الفطر"))
-        # Eid Al Fitr Holiday.
+        # Eid al-Fitr Holiday.
         self._add_eid_al_fitr_day_three(tr("عطلة عيد الفطر"))
 
-        # Eid Al Adha.
+        # Eid al-Adha.
         self._add_eid_al_adha_day(tr("عيد الأضحى"))
-        # Eid Al Adha Holiday.
+        # Eid al-Adha Holiday.
         self._add_eid_al_adha_day_two(tr("عطلة عيد الأضحى"))
         self._add_eid_al_adha_day_three(tr("عطلة عيد الأضحى"))
 

holidays/countries/bosnia_and_herzegovina.py

@@ -64,11 +64,14 @@ class BosniaAndHerzegovina(
         "BRC",  # Brčko distrikt
         "SRP",  # Republika Srpska
     )
-    _deprecated_subdivisions = (
-        "BD",
-        "FBiH",
-        "RS",
-    )
+    subdivisions_aliases = {
+        "Federacija Bosne i Hercegovine": "BIH",
+        "FBiH": "BIH",
+        "Brčko distrikt": "BRC",
+        "BD": "BRC",
+        "Republika Srpska": "SRP",
+        "RS": "SRP",
+    }
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
@@ -90,13 +93,6 @@ class BosniaAndHerzegovina(
         # Eid al-Adha.
         self._add_eid_al_adha_day(tr("Kurban Bajram"))
 
-        if self.subdiv == "BD":
-            self._populate_subdiv_brc_public_holidays()
-        elif self.subdiv == "FBiH":
-            self._populate_subdiv_bih_public_holidays()
-        elif self.subdiv == "RS":
-            self._populate_subdiv_srp_public_holidays()
-
     def _populate_subdiv_holidays(self):
         if not self.subdiv:
             # New Year's Day.

holidays/countries/brunei.py

@@ -156,7 +156,7 @@ class Brunei(
         # Israk dan Mikraj
         # Status: In-Use.
 
-        # Isra Mi'raj
+        # Isra' and Mi'raj
         for dt in self._add_isra_and_miraj_day(tr("Israk dan Mikraj")):
             self._add_observed(dt)
 
@@ -210,7 +210,7 @@ class Brunei(
         # Maulidur Rasul
         # Status: In-Use.
 
-        # Birth of the Prophet
+        # Prophet's Birthday
         for dt in self._add_mawlid_day(tr("Maulidur Rasul")):
             self._add_observed(dt)
 
@@ -249,6 +249,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (JUL, 20),
         2022: (JUL, 10),
         2023: (JUN, 29),
+        2024: (JUN, 17),
     }
 
     EID_AL_FITR_DATES = {
@@ -304,6 +305,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (AUG, 10),
         2022: (JUL, 30),
         2023: (JUL, 19),
+        2024: (JUL, 7),
     }
 
     ISRA_AND_MIRAJ_DATES = {
@@ -331,6 +333,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (MAR, 11),
         2022: (MAR, 1),
         2023: (FEB, 18),
+        2024: (FEB, 8),
     }
 
     MAWLID_DATES = {
@@ -358,6 +361,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (OCT, 19),
         2022: (OCT, 8),
         2023: (SEP, 28),
+        2024: (SEP, 16),
     }
 
     NUZUL_AL_QURAN_DATES = {
@@ -385,6 +389,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (APR, 29),
         2022: (APR, 19),
         2023: (APR, 8),
+        2024: (MAR, 28),
     }
 
     RAMADAN_BEGINNING_DATES = {
@@ -412,6 +417,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (APR, 13),
         2022: (APR, 3),
         2023: (MAR, 23),
+        2024: (MAR, 12),
     }
 
 

holidays/countries/cambodia.py

@@ -12,7 +12,7 @@
 
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import MAY, AUG, SEP, _timedelta
+from holidays.calendars.gregorian import APR, MAY, AUG, SEP, _timedelta
 from holidays.calendars.thai import KHMER_CALENDAR
 from holidays.groups import InternationalHolidays, StaticHolidays, ThaiCalendarHolidays
 from holidays.holiday_base import HolidayBase
@@ -39,8 +39,8 @@ class Cambodia(HolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarH
     - Exact Public Holidays as per Cambodia's Official Gazette are only
       available from 2015 onwards.
 
-    - Cambodian Lunar Calendar Holidays only work from 1941 (B.E. 2485) onwards until 2057
-      (B.E. 2601) as we only have Thai year-type data for cross-checking until then.
+    - Cambodian Lunar Calendar Holidays only work from 1941 (B.E. 2485) onwards until 2157
+      (B.E. 2701) as we only have Thai year-type data for cross-checking until then.
 
 
     Country created by: `PPsyrius <https://github.com/PPsyrius>`__
@@ -86,12 +86,25 @@ class Cambodia(HolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarH
 
         #  ពិធីបុណ្យចូលឆ្នាំថ្មីប្រពៃណីជាតិ
         # Status: In-Use.
-        # Usually falls on April 13th except for 2017-2018 and 2021-2023 for years 2001-2050.
+        # Usually falls on April 13th except for 2017-2018, 2021-2023, 2025-2027, 2029-2031
+        # for years 2001-2050.
 
         if self._year != 2020:
             # Khmer New Year's Day
             sangkranta = tr("ពិធីបុណ្យចូលឆ្នាំថ្មីប្រពៃណីជាតិ")
-            sangkranta_years_apr_14 = {2017, 2018, 2021, 2022, 2023}
+            sangkranta_years_apr_14 = {
+                2017,
+                2018,
+                2021,
+                2022,
+                2023,
+                2025,
+                2026,
+                2027,
+                2029,
+                2030,
+                2031,
+            }
             dt = (
                 self._add_holiday_apr_14(sangkranta)
                 if self._year in sangkranta_years_apr_14
@@ -215,7 +228,7 @@ class Cambodia(HolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarH
 
         # Cambodian Lunar Calendar Holidays
         # See `_ThaiLunisolar` in holidays/utils.py for more details.
-        # Cambodian Lunar Calendar Holidays only work from 1941 to 2057.
+        # Cambodian Lunar Calendar Holidays only work from 1941 to 2157.
 
         # ពិធីបុណ្យមាឃបូជា
         # Status: Defunct.
@@ -284,6 +297,9 @@ class CambodiaStaticHolidays:
     # Special Public Holiday
     special_in_lieu_holidays = tr("ថ្ងៃឈប់សម្រាកសងជំនួស")
 
+    # Khmer New Year's Day
+    sangkranta = tr("ពិធីបុណ្យចូលឆ្នាំថ្មីប្រពៃណីជាតិ")
+
     special_public_holidays = {
         2016: (
             (MAY, 2, special_in_lieu_holidays),
@@ -299,4 +315,5 @@ class CambodiaStaticHolidays:
             (AUG, 20, sangkranta_in_lieu_covid),
             (AUG, 21, sangkranta_in_lieu_covid),
         ),
+        2024: (APR, 16, sangkranta),
     }

holidays/countries/canada.py

@@ -294,16 +294,16 @@ class Canada(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
 
     def _populate_subdiv_nl_optional_holidays(self):
         if self._year >= 1900:
-            # St. Patrick's Day.
-            self._add_holiday(tr("St. Patrick's Day"), self._get_nearest_monday(MAR, 17))
+            # Saint Patrick's Day.
+            self._add_holiday(tr("Saint Patrick's Day"), self._get_nearest_monday(MAR, 17))
 
         if self._year >= 1990:
             # Nearest Monday to April 23
             # 4/26 is the Monday closer to 4/23 in 2010
             # but the holiday was observed on 4/19? Crazy Newfies!
             dt = date(2010, APR, 19) if self._year == 2010 else self._get_nearest_monday(APR, 23)
-            # St. George's Day.
-            self._add_holiday(tr("St. George's Day"), dt)
+            # Saint George's Day.
+            self._add_holiday(tr("Saint George's Day"), dt)
 
         if self._year >= 1997:
             # Discovery Day.
@@ -429,8 +429,8 @@ class Canada(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
 
         if self._year >= 1925:
             self._add_observed(
-                # St. Jean Baptiste Day.
-                self._add_saint_johns_day(tr("St. Jean Baptiste Day")),
+                # Saint John the Baptist Day.
+                self._add_saint_johns_day(tr("Saint Jean Baptiste Day")),
                 rule=SUN_TO_NEXT_MON,
             )
 

holidays/countries/croatia.py

@@ -100,7 +100,7 @@ class Croatia(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Christmas Day.
         self._add_christmas_day(tr("Božić"))
 
-        # St. Stephen's Day.
+        # Saint Stephen's Day.
         self._add_christmas_day_two(tr("Sveti Stjepan"))
 
 

holidays/countries/cyprus.py

@@ -92,7 +92,7 @@ class Cyprus(HolidayBase, ChristianHolidays, InternationalHolidays):
             return None
 
         # Easter Tuesday.
-        self._add_holiday_2_days_past_easter(tr("Τρίτη της Διακαινησίμου"))
+        self._add_easter_tuesday(tr("Τρίτη της Διακαινησίμου"))
 
     def _populate_optional_holidays(self):
         if self._year <= 1960:

holidays/countries/djibouti.py

@@ -51,7 +51,7 @@ class Djibouti(HolidayBase, ChristianHolidays, IslamicHolidays, InternationalHol
         # Christmas Day.
         self._add_christmas_day(tr("Noël"))
 
-        # Isra and Miraj.
+        # Isra' and Mi'raj.
         self._add_isra_and_miraj_day(tr("Al Isra et Al Mirague"))
 
         # Eid al-Fitr.

holidays/countries/dominica.py

@@ -0,0 +1,130 @@
+#  holidays
+#  --------
+#  A fast, efficient Python library for generating country, province and state
+#  specific sets of holidays on the fly. It aims to make determining whether a
+#  specific date is a holiday as fast and flexible as possible.
+#
+#  Authors: Vacanza Team and individual contributors (see AUTHORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/python-holidays
+#  License: MIT (see LICENSE file)
+
+from holidays.calendars.gregorian import JAN, JUL, SEP
+from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
+from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON, SUN_TO_NEXT_TUE
+
+
+class Dominica(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+    """
+    References:
+      - https://www.dominica.gov.dm/laws/chapters/chap19-10.pdf
+      - https://pressroomopm.gov.dm/notice-public-holiday-order-2022/
+      - https://en.wikipedia.org/wiki/Public_holidays_in_Dominica
+      - https://dominica.gov.dm/laws/1998/sro1-1998.pdf
+
+    Cross-Checked With:
+      - https://www.dominica-weekly.com/images/dominica-calendar-2010/1600-1280.jpg  # 2010
+      - https://dominicaconsulategreece.com/dominica/public-holidays/  # 2011-2020
+      - http://www.q95da.com/news/q95-news-received-on-december-29-2020-at-731pm-the-official-public-holiday-calendar-for-2021-approved-by-the-government-of-dominica
+      - https://dominica.gov.dm/about-dominica/public-holidays  # 2022-2024
+
+    While Labour Day is listed in the 1990 amendment as May 1st, this has, de facto, been
+    made 1st Monday of May since at least 2010.
+
+    Where in any year two public holidays fall on the same day, then the next succeeding day
+    not being itself a public holiday shall be observed as a public holiday. In practice, this
+    only applies to Holidays which falls on Saturday or Sunday.
+    """
+
+    country = "DM"
+    observed_label = "%s (observed)"
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, DominicaStaticHolidays)
+        kwargs.setdefault("observed_rule", SUN_TO_NEXT_MON)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Public Holidays Act, L.I. 12 of 1990 Amendment.
+        if self._year <= 1989:
+            return None
+
+        # New Year's Day.
+        self._add_observed(self._add_new_years_day("New Year's Day"))
+
+        # Carnival Monday.
+        self._add_carnival_monday("Carnival Monday")
+
+        # Carnival Tuesday.
+        self._add_carnival_tuesday("Carnival Tuesday")
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        # Labour Day.
+        labour_day_name = "Labour Day"
+        if self._year >= 2010:
+            self._add_holiday_1st_mon_of_may(labour_day_name)
+        else:
+            self._add_observed(self._add_labor_day(labour_day_name))
+
+        # Whit Monday.
+        self._add_whit_monday("Whit Monday")
+
+        first_monday_of_august_holiday_name = (
+            # Emancipation Day.
+            "Emancipation Day"
+            if self._year >= 1998
+            # First Monday of August.
+            else "First Monday of August"
+        )
+        self._add_holiday_1st_mon_of_aug(first_monday_of_august_holiday_name)
+
+        # Independence Day.
+        self._add_observed(self._add_holiday_nov_3("Independence Day"), rule=SUN_TO_NEXT_TUE)
+
+        # National Day of Community Service	.
+        self._add_observed(self._add_holiday_nov_4("National Day of Community Service"))
+
+        # Christmas Day.
+        self._add_observed(self._add_christmas_day("Christmas Day"), rule=SUN_TO_NEXT_TUE)
+
+        # Boxing Day.
+        self._add_observed(self._add_christmas_day_two("Boxing Day"))
+
+
+class DM(Dominica):
+    pass
+
+
+class DMA(Dominica):
+    pass
+
+
+class DominicaStaticHolidays:
+    """
+    References
+      - https://qppstudio-public-holidays-news.blogspot.com/2009/07/dominica-declares-july-28-public.html
+      - https://dominica.gov.dm/laws/2009/sro35-2009.pdf
+      - https://dominica.gov.dm/laws/2009/sro55-2009.pdf
+      - https://emonewsdm.com/thursday-september-19-2019-declared-public-holiday-in-dominica/
+    """
+
+    # Special Public Holidays.
+    special_public_holiday_name = "Special Public Holiday"
+
+    special_public_holidays = {
+        2009: (
+            (JUL, 28, special_public_holiday_name),
+            (SEP, 3, special_public_holiday_name),
+        ),
+        2010: (JAN, 4, special_public_holiday_name),
+        # Post-Hurricane Maria Thanksgiving Celebrations.
+        2019: (SEP, 19, "Post-Hurricane Maria Thanksgiving Celebrations"),
+    }

holidays/countries/dominican_republic.py

@@ -10,10 +10,8 @@
 #  Website: https://github.com/vacanza/python-holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import JUN
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
@@ -39,11 +37,11 @@ class DominicanRepublic(ObservedHolidayBase, ChristianHolidays, InternationalHol
         kwargs.setdefault("observed_rule", TUE_WED_TO_PREV_MON + THU_FRI_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
-    def _is_observed(self, dt: date) -> bool:
-        # Law No. 139-97 - Holidays Dominican Republic - Jun 27, 1997
-        return dt >= date(1997, JUN, 27)
-
     def _populate_public_holidays(self):
+        # Law No. 139-97 - Holidays Dominican Republic (Jun 27, 1997).
+        if self._year <= 1997:
+            return None
+
         # New Year's Day.
         self._add_new_years_day(tr("Año Nuevo"))
 
@@ -72,12 +70,9 @@ class DominicanRepublic(ObservedHolidayBase, ChristianHolidays, InternationalHol
         self._add_corpus_christi_day(tr("Corpus Christi"))
 
         # Restoration Day.
-        name = tr("Día de la Restauración")
-        # Judgment No. 14 of Feb 20, 2008 of the Supreme Court of Justice
-        if self._year <= 2007 and self._year % 4 == 0:
-            self._add_holiday_aug_16(name)
-        else:
-            self._move_holiday(self._add_holiday_aug_16(name))
+        aug_16 = self._add_holiday_aug_16(tr("Día de la Restauración"))
+        if self._year % 4 != 0:
+            self._move_holiday(aug_16)
 
         # Our Lady of Mercedes Day.
         self._add_holiday_sep_24(tr("Día de las Mercedes"))

holidays/countries/germany.py

@@ -13,6 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars.gregorian import MAY, OCT
+from holidays.constants import CATHOLIC, PUBLIC
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -54,13 +55,14 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
 
     country = "DE"
     default_language = "de"
-    supported_languages = ("de", "en_US", "uk")
+    supported_categories = (CATHOLIC, PUBLIC)
+    supported_languages = ("de", "en_US", "th", "uk")
     subdivisions = (
+        # ISO 3166-2:DE
         "BB",
         "BE",
         "BW",
         "BY",
-        "BYP",
         "HB",
         "HE",
         "HH",
@@ -74,6 +76,25 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         "ST",
         "TH",
     )
+    subdivisions_aliases = {
+        "Brandenburg": "BB",
+        "Berlin": "BE",
+        "Baden-Württemberg": "BW",
+        "Bayern": "BY",
+        "Bremen": "HB",
+        "Hessen": "HE",
+        "Hamburg": "HH",
+        "Mecklenburg-Vorpommern": "MV",
+        "Niedersachsen": "NI",
+        "Nordrhein-Westfalen": "NW",
+        "Rheinland-Pfalz": "RP",
+        "Schleswig-Holstein": "SH",
+        "Saarland": "SL",
+        "Sachsen": "SN",
+        "Sachsen-Anhalt": "ST",
+        "Thüringen": "TH",
+    }
+    _deprecated_subdivisions = ("BYP",)
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
@@ -117,6 +138,9 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         # Second Day of Christmas.
         self._add_christmas_day_two(tr("Zweiter Weihnachtstag"))
 
+        if self.subdiv == "BYP":
+            self._populate_subdiv_by_public_holidays()
+
     def _populate_subdiv_bb_public_holidays(self):
         if self._year <= 1989:
             return None
@@ -161,20 +185,14 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             self._add_epiphany_day(tr("Heilige Drei Könige"))
             self._add_corpus_christi_day(tr("Fronleichnam"))
 
-            # Assumption Day.
-            self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
-
         self._add_all_saints_day(tr("Allerheiligen"))
 
-    def _populate_subdiv_byp_public_holidays(self):
-        if self._year <= 1989:
+    def _populate_subdiv_by_catholic_holidays(self):
+        if self._year <= 1990:
             return None
 
-        if self._year >= 1991:
-            self._add_epiphany_day(tr("Heilige Drei Könige"))
-            self._add_corpus_christi_day(tr("Fronleichnam"))
-
-        self._add_all_saints_day(tr("Allerheiligen"))
+        # Assumption Day.
+        self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
     def _populate_subdiv_hb_public_holidays(self):
         if self._year <= 1989: