holidays 0.61__py3-none-any.whl → 0.63__py3-none-any.whl

holidays/countries/israel.py

@@ -54,6 +54,7 @@ class Israel(ObservedHolidayBase):
     supported_categories = (OPTIONAL, PUBLIC, SCHOOL)
     supported_languages = ("en_US", "he", "uk")
     weekend = {FRI, SAT}
+    start_year = 1948
 
     def __init__(self, *args, **kwargs):
         kwargs.setdefault("observed_rule", FRI_TO_PREV_THU + SAT_TO_PREV_THU)
@@ -63,12 +64,6 @@ class Israel(ObservedHolidayBase):
         return _HebrewLunisolar._get_holiday(holiday, self._year)
 
     def _populate_public_holidays(self):
-        if self._year <= 1947:
-            return None
-
-        if self._year >= 2101:
-            raise NotImplementedError
-
         # Rosh Hashanah (New Year).
         name = tr("ראש השנה")
         rosh_hashanah_dt = self._get_holiday(ROSH_HASHANAH)
@@ -78,10 +73,9 @@ class Israel(ObservedHolidayBase):
         # Yom Kippur (Day of Atonement).
         self._add_holiday(tr("יום כיפור"), self._get_holiday(YOM_KIPPUR))
 
-        # Sukkot (Feast of Tabernacles).
-        name = tr("סוכות")
         sukkot_dt = self._get_holiday(SUKKOT)
-        self._add_holiday(name, sukkot_dt)
+        # Sukkot (Feast of Tabernacles).
+        self._add_holiday(tr("סוכות"), sukkot_dt)
         # Simchat Torah / Shemini Atzeret.
         self._add_holiday(tr("שמחת תורה/שמיני עצרת"), _timedelta(sukkot_dt, +7))
 
@@ -105,12 +99,6 @@ class Israel(ObservedHolidayBase):
         self._add_holiday(tr("שבועות"), self._get_holiday(SHAVUOT))
 
     def _populate_optional_holidays(self):
-        if self._year <= 1947:
-            return None
-
-        if self._year >= 2101:
-            raise NotImplementedError
-
         sukkot_dt = self._get_holiday(SUKKOT)
         for offset in range(1, 6):
             # Chol HaMoed Sukkot (Feast of Tabernacles holiday).
@@ -151,12 +139,6 @@ class Israel(ObservedHolidayBase):
             self._add_holiday(name, tisha_bav_dt)
 
     def _populate_school_holidays(self):
-        if self._year <= 1947:
-            return None
-
-        if self._year >= 2101:
-            raise NotImplementedError
-
         sukkot_dt = self._get_holiday(SUKKOT)
         for offset in range(1, 6):
             # Chol HaMoed Sukkot (Feast of Tabernacles holiday).

holidays/countries/japan.py

@@ -43,6 +43,8 @@ class Japan(ObservedHolidayBase, InternationalHolidays, StaticHolidays):
     default_language = "ja"
     supported_categories = (BANK, PUBLIC)
     supported_languages = ("en_US", "ja", "th")
+    start_year = 1949
+    end_year = 2099
 
     def __init__(self, *args, **kwargs) -> None:
         InternationalHolidays.__init__(self)
@@ -80,9 +82,6 @@ class Japan(ObservedHolidayBase, InternationalHolidays, StaticHolidays):
                     break
 
     def _populate_public_holidays(self):
-        if self._year < 1949 or self._year > 2099:
-            raise NotImplementedError
-
         dts_observed = set()
 
         # New Year's Day.
@@ -199,9 +198,6 @@ class Japan(ObservedHolidayBase, InternationalHolidays, StaticHolidays):
             self._populate_observed(dts_observed)
 
     def _populate_bank_holidays(self):
-        if self._year < 1949 or self._year > 2099:
-            raise NotImplementedError
-
         # Bank Holiday.
         name = tr("銀行休業日")
         self._add_new_years_day(name)

holidays/countries/jersey.py

@@ -48,6 +48,8 @@ class Jersey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
 
     country = "JE"
     observed_label = "%s (substitute day)"
+    # Earliest available piece of law available is from 1952.
+    start_year = 1952
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -65,10 +67,6 @@ class Jersey(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         return super()._add_observed(dt, **kwargs)
 
     def _populate_public_holidays(self) -> None:
-        # Earliest available piece of law available is from 1952.
-        if self._year <= 1951:
-            return None
-
         # New Year's Day.
         # Available online source shown that this was celebrated since at least 1952.
         # Was briefly removed in 1983 only to be added back again before that came to effect.

holidays/countries/kazakhstan.py

@@ -74,6 +74,10 @@ class Kazakhstan(
         - `2022 <https://adilet.zan.kz/kaz/docs/P2200000796>`_
         - `2023 <https://adilet.zan.kz/kaz/docs/P2300000326>`_
         - `2024 <https://adilet.zan.kz/kaz/docs/G24G0000109>`_
+        - `2025 <https://adilet.zan.kz/kaz/docs/G24G0000436>`_
+
+    Islamic holidays:
+        - 2025: `<https://en.inform.kz/news/first-day-of-ramadan-to-fall-on-march-1-2025-ca393f/>`_
     """
 
     country = "KZ"
@@ -85,6 +89,8 @@ class Kazakhstan(
     # %s (observed, estimated).
     observed_estimated_label = tr("%s (қайта белгіленген демалыс, бағаланған)")
     supported_languages = ("en_US", "kk", "uk")
+    # Kazakhstan declared its sovereignty on 25 October 1990.
+    start_year = 1991
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
@@ -96,10 +102,6 @@ class Kazakhstan(
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Kazakhstan declared its sovereignty on 25 October 1990
-        if self._year <= 1990:
-            return None
-
         dts_observed = set()
 
         # New Year's Day.
@@ -197,6 +199,7 @@ class KazakhstanIslamicHolidays(_CustomIslamicHolidays):
         2022: (JUL, 9),
         2023: (JUN, 28),
         2024: (JUN, 16),
+        2025: (JUN, 6),
     }
 
 
@@ -286,6 +289,7 @@ class KazakhstanStaticHolidays:
         ),
         2023: (JUL, 7, JUL, 1),
         2024: (MAY, 8, MAY, 4),
+        2025: (JAN, 3, JAN, 5),
     }
 
     special_public_holidays_observed = {

holidays/countries/kenya.py

@@ -24,6 +24,7 @@ class Kenya(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stati
 
     country = "KE"
     observed_label = "%s (observed)"
+    start_year = 1963
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -33,9 +34,6 @@ class Kenya(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stati
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1962:
-            return None
-
         # New Year's Day
         self._add_observed(self._add_new_years_day("New Year's Day"))
 

holidays/countries/laos.py

@@ -66,6 +66,8 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
     # %s (in lieu).
     observed_label = tr("ພັກຊົດເຊີຍ%s")
     supported_languages = ("en_US", "lo", "th")
+    # Available post-Lao PDR proclamation on Dec 2, 1975.
+    start_year = 1976
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)
@@ -77,9 +79,6 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
 
     def _populate_bank_holidays(self):
         # Based on both LSX and BCEL calendar.
-        # Available post-Lao PDR proclamation on Dec 2, 1975.
-        if self._year <= 1975:
-            return None
 
         # ວັນສ້າງຕັ້ງທະນາຄານແຫ່ງ ສປປ ລາວ
         # Status: In-Use.
@@ -109,10 +108,6 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
         self._add_holiday(name, self._get_next_workday(second_to_last_workday, -1))
 
     def _populate_public_holidays(self):
-        # Available post-Lao PDR proclamation on Dec 2, 1975.
-        if self._year <= 1975:
-            return None
-
         # ວັນປີໃໝ່ສາກົນ
         # Status: In-Use.
 
@@ -178,8 +173,6 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
         # As such, no in lieu observance are in place for these holidays.
 
         # Laotian Lunar Calendar Holidays only work from 1941 to 2157.
-        if self._year <= 1975:
-            return None
 
         # ວັນບຸນມາຂະບູຊາ
         # Status: In-Use.
@@ -253,10 +246,6 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
     def _populate_workday_holidays(self):
         # No Public Holidays are issued, though still observed by the government.
 
-        # Available post-Lao PDR proclamation on Dec 2, 1975.
-        if self._year <= 1975:
-            return None
-
         # ວັນສ້າງຕັ້ງກອງທັບປະຊາຊົນລາວ
         # Status: In-Use.
         # Celebrated the creation of the independent Lao army on Jan 20, 1949.

holidays/countries/latvia.py

@@ -29,6 +29,7 @@ class Latvia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
     # %s (observed).
     observed_label = tr("%s (brīvdiena)")
     supported_languages = ("en_US", "lv", "uk")
+    start_year = 1990
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -38,9 +39,6 @@ class Latvia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1989:
-            return None
-
         # New Year's Day.
         self._add_new_years_day(tr("Jaunais Gads"))
 
@@ -57,10 +55,8 @@ class Latvia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         self._add_labor_day(tr("Darba svētki"))
 
         if self._year >= 2002:
-            dt = self._add_holiday_may_4(
-                # Restoration of Independence Day.
-                tr("Latvijas Republikas Neatkarības atjaunošanas diena")
-            )
+            # Restoration of Independence Day.
+            dt = self._add_holiday_may_4(tr("Latvijas Republikas Neatkarības atjaunošanas diena"))
             if self._year >= 2008:
                 self._add_observed(dt)
 

holidays/countries/lesotho.py

@@ -24,6 +24,7 @@ class Lesotho(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
     """
 
     country = "LS"
+    start_year = 1996
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -32,9 +33,6 @@ class Lesotho(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1995:
-            return None
-
         # New Year's Day.
         self._add_new_years_day("New Year's Day")
 

holidays/countries/lithuania.py

@@ -28,6 +28,7 @@ class Lithuania(HolidayBase, ChristianHolidays, InternationalHolidays):
     country = "LT"
     default_language = "lt"
     supported_languages = ("en_US", "lt", "uk")
+    start_year = 1990
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
@@ -35,9 +36,6 @@ class Lithuania(HolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self) -> None:
-        if self._year <= 1989:
-            return None
-
         # New Year's Day.
         self._add_new_years_day(tr("Naujųjų metų diena"))
 
@@ -72,7 +70,7 @@ class Lithuania(HolidayBase, ChristianHolidays, InternationalHolidays):
                 tr(
                     "Valstybės (Lietuvos karaliaus Mindaugo karūnavimo) "
                     "ir Tautiškos giesmės diena"
-                ),
+                )
             )
 
         # Assumption Day.

holidays/countries/madagascar.py

@@ -27,6 +27,7 @@ class Madagascar(HolidayBase, ChristianHolidays, InternationalHolidays):
     country = "MG"
     default_language = "mg"
     supported_languages = ("en_US", "mg", "uk")
+    start_year = 1947
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -34,10 +35,6 @@ class Madagascar(HolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Observed since 1947
-        if self._year <= 1946:
-            return None
-
         # New Year's Day.
         self._add_new_years_day(tr("Taom-baovao"))
 

holidays/countries/malawi.py

@@ -26,6 +26,7 @@ class Malawi(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
 
     country = "MW"
     observed_label = "%s (observed)"
+    start_year = 2000
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -34,10 +35,6 @@ class Malawi(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Observed since 2000
-        if self._year <= 1999:
-            return None
-
         self._add_observed(self._add_new_years_day("New Year's Day"))
 
         self._add_observed(self._add_holiday_jan_15("John Chilembwe Day"))

holidays/countries/malaysia.py

@@ -123,6 +123,7 @@ class Malaysia(
         "PJY": "16",
     }
     supported_languages = ("en_US", "ms_MY", "th")
+    start_year = 1952
 
     def __init__(self, *args, **kwargs):
         """
@@ -152,9 +153,6 @@ class Malaysia(
         self.dts_observed = set()
 
     def _populate_public_holidays(self):
-        if self._year <= 1951:
-            return None
-
         # This must be done for every `_populate_public_holidays()` call.
         # Otherwise, 2006/2007 Eid al-Adha observance would be miscalculated.
         self.dts_observed = set()
@@ -212,9 +210,6 @@ class Malaysia(
         self.dts_observed.update(self._add_eid_al_adha_day(tr("Hari Raya Qurban")))
 
     def _populate_subdiv_holidays(self):
-        if self._year <= 1951:
-            return None
-
         if self.subdiv and self.subdiv not in {"13", "15"}:
             # Deepavali.
             self.dts_observed.add(self._add_diwali(tr("Hari Deepavali")))

holidays/countries/malta.py

@@ -40,6 +40,8 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
     country = "MT"
     default_language = "mt"
     supported_languages = ("en_US", "mt")
+    # Earliest available source is 1980.
+    start_year = 1980
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -47,10 +49,6 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Earliest available source is 1980
-        if self._year <= 1979:
-            return None
-
         # L-Ewwel tas-Sena
         # Status: In-Use.
 

holidays/countries/moldova.py

@@ -27,6 +27,7 @@ class Moldova(HolidayBase, ChristianHolidays, InternationalHolidays):
     country = "MD"
     default_language = "ro"
     supported_languages = ("en_US", "ro", "uk")
+    start_year = 1991
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
@@ -34,9 +35,6 @@ class Moldova(HolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1990:
-            return None
-
         # New Year's Day.
         self._add_new_years_day(tr("Anul Nou"))
 

holidays/countries/mozambique.py

@@ -22,6 +22,7 @@ class Mozambique(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
     # %s (observed).
     observed_label = tr("%s (ponte)")
     supported_languages = ("en_US", "pt_MZ", "uk")
+    start_year = 1975
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -30,9 +31,6 @@ class Mozambique(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1974:
-            return None
-
         # International Fraternalism Day.
         self._add_observed(self._add_new_years_day(tr("Dia da Fraternidade universal")))
 

holidays/countries/namibia.py

@@ -30,6 +30,7 @@ class Namibia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
     country = "NA"
     # %s (observed).
     observed_label = "%s (observed)"
+    start_year = 1990
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -40,9 +41,6 @@ class Namibia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1989:
-            return None
-
         # New Year's Day.
         self._add_observed(self._add_new_years_day("New Year's Day"))
 
@@ -75,7 +73,7 @@ class Namibia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
             self._add_holiday_sep_10(
                 "Day of the Namibian Women and International Human Rights Day"
                 if self._year >= 2005
-                else "International Human Rights Day",
+                else "International Human Rights Day"
             )
         )
 

holidays/countries/netherlands.py

@@ -32,6 +32,7 @@ class Netherlands(HolidayBase, ChristianHolidays, InternationalHolidays):
     default_language = "nl"
     supported_categories = (OPTIONAL, PUBLIC)
     supported_languages = ("en_US", "nl", "uk")
+    start_year = 1801
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)

holidays/countries/new_zealand.py

@@ -112,6 +112,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         "STC",  # For 'South Canterbury' Subregional Holidays.
         "WTL",  # Westland, Correct code is WTC (for West Coast).
     )
+    start_year = 1894
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -121,9 +122,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         super().__init__(*args, **kwargs)
 
     def _get_nearest_monday(self, *args) -> Optional[date]:
-        dt = args if len(args) > 1 else args[0]
-        dt = dt if isinstance(dt, date) else date(self._year, *dt)
-        return self._get_observed_date(dt, rule=ALL_TO_NEAREST_MON)
+        return self._get_observed_date(date(self._year, *args), rule=ALL_TO_NEAREST_MON)
 
     def _populate_public_holidays(self):
         # Bank Holidays Act 1873
@@ -137,9 +136,6 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         # Sovereign's Birthday Observance Act 1937, 1952
         # Holidays Act 1981, 2003
 
-        if self._year <= 1893:
-            return None
-
         # New Year's Day
         self._add_observed(self._add_new_years_day("New Year's Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
         self._add_observed(
@@ -258,12 +254,9 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
 
     def _populate_subdiv_ntl_public_holidays(self):
         if 1964 <= self._year <= 1973:
-            name = "Waitangi Day"
-            dt = (FEB, 6)
+            self._add_holiday("Waitangi Day", self._get_nearest_monday(FEB, 6))
         else:
-            name = "Auckland Anniversary Day"
-            dt = (JAN, 29)
-        self._add_holiday(name, self._get_nearest_monday(dt))
+            self._add_holiday("Auckland Anniversary Day", self._get_nearest_monday(JAN, 29))
 
     def _populate_subdiv_ota_public_holidays(self):
         # there is no easily determined single day of local observance?!?!

holidays/countries/nigeria.py

@@ -29,6 +29,7 @@ class Nigeria(
 
     country = "NG"
     observed_label = "%s (observed)"
+    start_year = 1979
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -40,9 +41,6 @@ class Nigeria(
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1978:
-            return None
-
         dts_observed = set()
 
         # New Year's Day.

holidays/countries/pakistan.py

@@ -18,6 +18,7 @@ from holidays.holiday_base import HolidayBase
 
 class Pakistan(HolidayBase, InternationalHolidays, IslamicHolidays):
     country = "PK"
+    start_year = 1948
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)
@@ -25,9 +26,6 @@ class Pakistan(HolidayBase, InternationalHolidays, IslamicHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1947:
-            return None
-
         # Kashmir Solidarity Day.
         if self._year >= 1990:
             self._add_holiday_feb_5("Kashmir Solidarity Day")

holidays/countries/palau.py

@@ -37,6 +37,11 @@ class Palau(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
     country = "PW"
     supported_categories = (ARMED_FORCES, HALF_DAY, PUBLIC)
     observed_label = "%s (observed)"
+    # Republic of Palau Public Law No. 2-15.
+    # The legislation was first adopted by the 2nd Olbiil Era Kelulau (1984-1988),
+    # but since we cannot find any info on its actual adoption date, we may as
+    # well use the formation date of the country as the placeholder cut-off date.
+    start_year = 1981
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -46,13 +51,6 @@ class Palau(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Republic of Palau Public Law No. 2-15.
-        # The legislation was first adopted by the 2nd Olbiil Era Kelulau (1984-1988),
-        # but since we cannot find any info on its actual adoption date, we may as
-        # well use the formation date of the country as the placeholder cut-off date.
-        if self._year <= 1980:
-            return None
-
         # Fixed Date Public Holidays.
 
         # New Year's Day.

holidays/countries/papua_new_guinea.py

@@ -42,6 +42,8 @@ class PapuaNewGuinea(
 
     country = "PG"
     observed_label = "%s (observed)"
+    # Public Holidays Law 1953 (No. 38 of 1953).
+    start_year = 1953
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -51,10 +53,6 @@ class PapuaNewGuinea(
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Public Holidays Law 1953 (No. 38 of 1953).
-        if self._year <= 1952:
-            return None
-
         # Section 1: Public Holidays.
         # - Easter Saturday is currently not gazetted as a Public Holiday in 2024.
         # - While Easter Sunday itself is not listed, this is de facto always a day-off.