holidays 0.54__py3-none-any.whl → 0.56__py3-none-any.whl

holidays/__init__.py

@@ -23,7 +23,7 @@ from holidays.holiday_base import *
 from holidays.registry import EntityLoader
 from holidays.utils import *
 
-__version__ = "0.54"
+__version__ = "0.56"
 
 
 EntityLoader.load("countries", globals())

holidays/countries/__init__.py

@@ -53,6 +53,7 @@ from .cyprus import Cyprus, CY, CYP
 from .czechia import Czechia, CZ, CZE
 from .denmark import Denmark, DK, DNK
 from .djibouti import Djibouti, DJ, DJI
+from .dominica import Dominica, DM, DMA
 from .dominican_republic import DominicanRepublic, DO, DOM
 from .ecuador import Ecuador, EC, ECU
 from .egypt import Egypt, EG, EGY
@@ -70,6 +71,7 @@ from .greece import Greece, GR, GRC
 from .greenland import Greenland, GL, GRL
 from .guam import Guam, GU, GUM, HolidaysGU
 from .guatemala import Guatemala, GT, GUA
+from .haiti import Haiti, HT, HTI
 from .honduras import Honduras, HN, HND
 from .hongkong import HongKong, HK, HKG
 from .hungary import Hungary, HU, HUN
@@ -128,6 +130,7 @@ from .portugal import Portugal, PT, PRT
 from .puerto_rico import PuertoRico, PR, PRI, HolidaysPR
 from .romania import Romania, RO, ROU
 from .russia import Russia, RU, RUS
+from .samoa import Samoa, WS, WSM
 from .san_marino import SanMarino, SM, SMR
 from .saudi_arabia import SaudiArabia, SA, SAU
 from .serbia import Serbia, RS, SRB

holidays/countries/algeria.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import THU, FRI, SAT, SUN
 from holidays.groups import InternationalHolidays, IslamicHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -38,6 +39,16 @@ class Algeria(HolidayBase, InternationalHolidays, IslamicHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        # The resting days are Friday and Saturday since 2009.
+        # Previously, these were on Thursday and Friday as implemented in 1976.
+        # https://www.thenationalnews.com/mena/2021/12/07/when-is-the-weekend-in-the-arab-world/
+        if self._year >= 2009:
+            self.weekend = {FRI, SAT}
+        elif self._year >= 1976:
+            self.weekend = {THU, FRI}
+        else:
+            self.weekend = {SAT, SUN}
+
         # New Year's Day.
         self._add_new_years_day(tr("رأس السنة الميلادية"))
 

holidays/countries/australia.py

@@ -696,7 +696,7 @@ class Australia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, S
 
         # Easter Tuesday.
         if self._year <= 2010:
-            self._add_holiday_2_days_past_easter("Easter Tuesday")
+            self._add_easter_tuesday("Easter Tuesday")
 
         # ANZAC Day.
         if self._year >= 1921:

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/bangladesh.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.calendars.gregorian import FRI, SAT
 from holidays.groups import InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -22,6 +23,7 @@ class Bangladesh(HolidayBase, InternationalHolidays):
     """
 
     country = "BD"
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)

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

@@ -13,7 +13,22 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.calendars.gregorian import (
+    JAN,
+    FEB,
+    MAR,
+    APR,
+    MAY,
+    JUN,
+    JUL,
+    AUG,
+    SEP,
+    OCT,
+    NOV,
+    DEC,
+    FRI,
+    SUN,
+)
 from holidays.groups import (
     ChineseCalendarHolidays,
     ChristianHolidays,
@@ -75,6 +90,7 @@ class Brunei(
     # %s (observed, estimated).
     observed_estimated_label = tr("%s (diperhatikan, anggaran)")
     supported_languages = ("en_US", "ms", "th")
+    weekend = {FRI, SUN}
 
     def __init__(self, *args, **kwargs):
         ChineseCalendarHolidays.__init__(self)
@@ -233,6 +249,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (JUL, 20),
         2022: (JUL, 10),
         2023: (JUN, 29),
+        2024: (JUN, 17),
     }
 
     EID_AL_FITR_DATES = {
@@ -288,6 +305,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (AUG, 10),
         2022: (JUL, 30),
         2023: (JUL, 19),
+        2024: (JUL, 7),
     }
 
     ISRA_AND_MIRAJ_DATES = {
@@ -315,6 +333,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (MAR, 11),
         2022: (MAR, 1),
         2023: (FEB, 18),
+        2024: (FEB, 8),
     }
 
     MAWLID_DATES = {
@@ -342,6 +361,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (OCT, 19),
         2022: (OCT, 8),
         2023: (SEP, 28),
+        2024: (SEP, 16),
     }
 
     NUZUL_AL_QURAN_DATES = {
@@ -369,6 +389,7 @@ class BruneiIslamicHolidays(_CustomIslamicHolidays):
         2021: (APR, 29),
         2022: (APR, 19),
         2023: (APR, 8),
+        2024: (MAR, 28),
     }
 
     RAMADAN_BEGINNING_DATES = {
@@ -396,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
@@ -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
@@ -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/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/egypt.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import FRI, SAT
 from holidays.calendars.julian import JULIAN_CALENDAR
 from holidays.groups import ChristianHolidays, IslamicHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
@@ -32,6 +33,7 @@ class Egypt(HolidayBase, ChristianHolidays, IslamicHolidays, InternationalHolida
     # %s (estimated).
     estimated_label = tr("(تقدير) %s")
     supported_languages = ("ar", "en_US")
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)