holidays 0.68__py3-none-any.whl → 0.69__py3-none-any.whl

holidays/countries/united_states.py

@@ -13,7 +13,7 @@
 from typing import Union
 
 from holidays.calendars.gregorian import MON, TUE, WED, THU, FRI, SAT, SUN
-from holidays.constants import PUBLIC, UNOFFICIAL
+from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
@@ -35,6 +35,9 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
     """
     https://en.wikipedia.org/wiki/Public_holidays_in_the_United_States
 
+    Federal holidays:
+        - https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/
+
     For Northern Mariana Islands (subdivision MP):
     - https://governor.gov.mp/archived-news/executive-actions-archive/memorandum-2022-legal-holidays/
     - https://webcache.googleusercontent.com/search?q=cache:C17_7FBgPtQJ:https://governor.gov.mp/archived-news/executive-actions-archive/memorandum-2022-legal-holidays/&hl=en&gl=sg&strip=1&vwsrc=0
@@ -62,6 +65,7 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         - IN: https://digital.statelib.lib.in.us/infoexpress/holidays.aspx
               https://www.in.gov/spd/benefits/state-holidays/
         - MD: https://msa.maryland.gov/msa/mdmanual/01glance/html/holidayl.html
+        - MI: https://www.michigan.gov/som/government/state-holidays
         - MN: https://www.revisor.mn.gov/statutes/cite/645.44
         - MT: https://archive.legmt.gov/bills/mca/title_0010/chapter_0010/part_0020/section_0160/0010-0010-0020-0160.html
         - NJ: https://nj.gov/nj/about/facts/holidays/
@@ -85,7 +89,7 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
     """
 
     country = "US"
-    supported_categories = (PUBLIC, UNOFFICIAL)
+    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
     observed_label = "%s (observed)"
     subdivisions: Union[tuple[()], tuple[str, ...]] = (
         "AK",  # Alaska.
@@ -160,20 +164,35 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         kwargs.setdefault("observed_rule", SAT_TO_PREV_FRI + SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
+    def _populate_common(self, include_federal: bool = False):
+        """
+        Populates common US holidays.
+
+        :param include_federal:
+            Whether to include federal-specific holidays.
+        """
         # New Year's Day
         if self._year >= 1871:
             name = "New Year's Day"
             self._add_observed(self._add_new_years_day(name))
             self._add_observed(self._next_year_new_years_day, name=name)
 
+        if include_federal:
+            # Birthday of Martin Luther King, Jr.
+            if self._year >= 1986:
+                self._add_holiday_3rd_mon_of_jan("Birthday of Martin Luther King, Jr.")
+
+            # Washington's Birthday
+            if self._year >= 1879:
+                name = "Washington's Birthday"
+                if self._year >= 1971:
+                    self._add_holiday_3rd_mon_of_feb(name)
+                else:
+                    self._add_holiday_feb_22(name)
+
         # Memorial Day
-        if self._year >= 1888:
-            name = "Memorial Day"
-            if self._year >= 1971:
-                self._add_holiday_last_mon_of_may(name)
-            else:
-                self._add_holiday_may_30(name)
+        if self._year >= 1971:
+            self._add_holiday_last_mon_of_may("Memorial Day")
 
         # Juneteenth Day
         if self._year >= 2021:
@@ -187,6 +206,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1894:
             self._add_holiday_1st_mon_of_sep("Labor Day")
 
+        if include_federal:
+            # Columbus Day
+            if self._year >= 1971:
+                self._add_holiday_2nd_mon_of_oct("Columbus Day")
+
         # Veterans Day
         if self._year >= 1938:
             name = "Veterans Day" if self._year >= 1954 else "Armistice Day"
@@ -195,14 +219,21 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             else:
                 self._add_observed(self._add_remembrance_day(name))
 
-        # Thanksgiving
+        # Thanksgiving Day
         if self._year >= 1871:
-            self._add_holiday_4th_thu_of_nov("Thanksgiving")
+            self._add_holiday_4th_thu_of_nov("Thanksgiving Day")
 
         # Christmas Day
         if self._year >= 1871:
             self._add_observed(self._add_christmas_day("Christmas Day"))
 
+    def _populate_public_holidays(self):
+        self._populate_common()
+
+        # Memorial Day
+        if 1888 <= self._year <= 1970:
+            self._add_holiday_may_30("Memorial Day")
+
     def _add_christmas_eve_holiday(self):
         # Christmas Eve
         # If on Friday, observed on Thursday
@@ -324,11 +355,12 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_3rd_mon_of_jan("Martin Luther King, Jr & Robert E. Lee's Birthday")
 
         # Washington's Birthday
-        name = "George Washington & Thomas Jefferson's Birthday"
-        if self._year >= 1971:
-            self._add_holiday_3rd_mon_of_feb(name)
-        else:
-            self._add_holiday_feb_22(name)
+        if self._year >= 1879:
+            name = "George Washington & Thomas Jefferson's Birthday"
+            if self._year >= 1971:
+                self._add_holiday_3rd_mon_of_feb(name)
+            else:
+                self._add_holiday_feb_22(name)
 
         # Confederate Memorial Day
         if self._year >= 1866:
@@ -356,11 +388,12 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             )
 
         # Washington's Birthday
-        name = "George Washington's Birthday and Daisy Gatson Bates Day"
-        if self._year >= 1971:
-            self._add_holiday_3rd_mon_of_feb(name)
-        else:
-            self._add_holiday_feb_22(name)
+        if self._year >= 1879:
+            name = "George Washington's Birthday and Daisy Gatson Bates Day"
+            if self._year >= 1971:
+                self._add_holiday_3rd_mon_of_feb(name)
+            else:
+                self._add_holiday_feb_22(name)
 
     def _populate_subdiv_as_public_holidays(self):
         # American Samoa Flag Day
@@ -493,10 +526,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             )
 
         # Washington's Birthday
-        self._add_holiday(
-            "Washington's Birthday",
-            self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
-        )
+        if self._year >= 1879:
+            self._add_holiday(
+                "Washington's Birthday",
+                self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
+            )
 
     def _populate_subdiv_gu_public_holidays(self):
         # Guam Discovery Day
@@ -587,10 +621,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_1_day_past_4th_thu_of_nov("Lincoln's Birthday")
 
         # Washington's Birthday
-        self._add_holiday(
-            "Washington's Birthday",
-            self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
-        )
+        if self._year >= 1879:
+            self._add_holiday(
+                "Washington's Birthday",
+                self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
+            )
 
     def _populate_subdiv_ks_public_holidays(self):
         # Christmas Eve
@@ -684,6 +719,14 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             # New Year's Eve
             self._add_observed(self._add_new_years_eve("New Year's Eve"))
 
+        # Election Day
+        if self._year >= 2008 and self._year % 2 == 0:
+            self._add_holiday_1_day_past_1st_mon_of_nov("Election Day")
+
+        # Day after Thanksgiving
+        if self._year >= 2017:
+            self._add_holiday_1_day_past_4th_thu_of_nov("Day After Thanksgiving")
+
     def _populate_subdiv_mn_public_holidays(self):
         # Washington's Birthday
         if self._year >= 1971:
@@ -872,7 +915,8 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         self._add_epiphany_day("Epiphany")
 
         # Washington's Birthday
-        self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
 
         # Emancipation Day
         self._add_observed(self._add_holiday_mar_22("Emancipation Day"), rule=SUN_TO_NEXT_MON)
@@ -1015,11 +1059,12 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         self._add_epiphany_day("Three Kings Day")
 
         # Washington's Birthday
-        name = "Presidents' Day"
-        if self._year >= 1971:
-            self._add_holiday_3rd_mon_of_feb(name)
-        else:
-            self._add_holiday_feb_22(name)
+        if self._year >= 1879:
+            name = "Presidents' Day"
+            if self._year >= 1971:
+                self._add_holiday_3rd_mon_of_feb(name)
+            else:
+                self._add_holiday_feb_22(name)
 
         # Transfer Day
         self._add_holiday_mar_31("Transfer Day")
@@ -1102,6 +1147,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1971:
             self._add_holiday_3rd_mon_of_feb("President's Day")
 
+    def _populate_government_holidays(self):
+        # Federal holidays in the United States.
+        self._populate_common(include_federal=True)
+
     def _populate_unofficial_holidays(self):
         # Very common celebrated cultural days, but no official observance.
         # Due to its nature, no in-lieus are observed.

holidays/countries/united_states_minor_outlying_islands.py

@@ -10,7 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import PUBLIC, UNOFFICIAL
+from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -20,13 +20,17 @@ class HolidaysUM(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "UM"
-    supported_categories = (PUBLIC, UNOFFICIAL)
+    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "UM"
         super()._populate_public_holidays()
 
+    def _populate_government_holidays(self) -> None:
+        self.subdiv = "UM"
+        super()._populate_government_holidays()
+
     def _populate_unofficial_holidays(self) -> None:
         self.subdiv = "UM"
         super()._populate_unofficial_holidays()

holidays/countries/united_states_virgin_islands.py

@@ -10,7 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import PUBLIC, UNOFFICIAL
+from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -20,13 +20,17 @@ class HolidaysVI(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "VI"
-    supported_categories = (PUBLIC, UNOFFICIAL)
+    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "VI"
         super()._populate_public_holidays()
 
+    def _populate_government_holidays(self) -> None:
+        self.subdiv = "VI"
+        super()._populate_government_holidays()
+
     def _populate_unofficial_holidays(self) -> None:
         self.subdiv = "VI"
         super()._populate_unofficial_holidays()

holidays/countries/uzbekistan.py

@@ -38,9 +38,15 @@ class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, St
     supported_languages = ("en_US", "uk", "uz")
     start_year = 1992
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, UzbekistanIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=UzbekistanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, UzbekistanStaticHolidays)
         kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_WORKDAY)
         super().__init__(*args, **kwargs)

holidays/groups/__init__.py

@@ -12,6 +12,7 @@
 
 # flake8: noqa: F401
 
+from holidays.groups.balinese_saka import BalineseSakaCalendarHolidays
 from holidays.groups.buddhist import BuddhistCalendarHolidays
 from holidays.groups.chinese import ChineseCalendarHolidays
 from holidays.groups.christian import ChristianHolidays

holidays/groups/balinese_saka.py

@@ -0,0 +1,45 @@
+#  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/holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from typing import Optional
+
+from holidays.calendars import _BalineseSakaLunar
+
+
+class BalineseSakaCalendarHolidays:
+    """
+    Balinese Saka lunar calendar holidays.
+    """
+
+    def __init__(self) -> None:
+        self._balinese_saka_calendar = _BalineseSakaLunar()
+
+    def _add_balinese_saka_calendar_holiday(self, name: str, dt: Optional[date]) -> Optional[date]:
+        """
+        Add Balinese Saka calendar holiday.
+        """
+        if dt is None:
+            return None
+        return self._add_holiday(name, dt)
+
+    def _add_nyepi(self, name) -> Optional[date]:
+        """
+        Add Nyepi (Day following the 9th of Dark Moon (Tilem)).
+
+        Nyepi is a Balinese "Day of Silence" that is commemorated every
+        Isakawarsa (Saka new year) according to the Balinese calendar.
+        https://en.wikipedia.org/wiki/Nyepi
+        """
+        return self._add_balinese_saka_calendar_holiday(
+            name, self._balinese_saka_calendar.nyepi_date(self._year)
+        )

holidays/groups/chinese.py

@@ -14,7 +14,7 @@ from datetime import date
 from typing import Optional
 
 from holidays.calendars import _ChineseLunisolar
-from holidays.calendars.gregorian import APR
+from holidays.calendars.gregorian import APR, DEC
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -35,7 +35,10 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
         return self._chinese_calendar.lunar_new_year_date(self._year)[0]
 
     @property
-    def _qingming_date(self):
+    def _qingming_festival(self):
+        """
+        Return Qingming Festival (15th day after the Spring Equinox) date.
+        """
         day = 5
         if (self._year % 4 < 1) or (self._year % 4 < 2 and self._year >= 2009):
             day = 4
@@ -48,6 +51,47 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
         """
         return self._chinese_calendar.mid_autumn_date(self._year)[0]
 
+    @property
+    def _chinese_birthday_of_buddha(self):
+        """
+        Return Add Birthday of the Buddha by Chinese lunar calendar (8th day of the
+        4th lunar month).
+        """
+        return self._chinese_calendar.buddha_birthday_date(self._year)[0]
+
+    @property
+    def _dragon_boat_festival(self):
+        """
+        Return Dragon Boat Festival (5th day of 5th lunar month) date.
+        """
+        return self._chinese_calendar.dragon_boat_date(self._year)[0]
+
+    @property
+    def _double_ninth_festival(self):
+        """
+        Return Double Ninth Festival (9th day of 9th lunar month) date.
+        """
+        return self._chinese_calendar.double_ninth_date(self._year)[0]
+
+    @property
+    def _dongzhi_festival(self):
+        """
+        Return Dongzhi Festival (Chinese Winter Solstice) date.
+
+        This approximation is reliable for 1952-2099 years.
+        """
+        #
+        if (
+            (self._year % 4 == 0 and self._year >= 1988)
+            or (self._year % 4 == 1 and self._year >= 2021)
+            or (self._year % 4 == 2 and self._year >= 2058)
+            or (self._year % 4 == 3 and self._year >= 2091)
+        ):
+            day = 21
+        else:
+            day = 22
+        return date(self._year, DEC, day)
+
     def _add_chinese_calendar_holiday(
         self, name: str, dt_estimated: tuple[Optional[date], bool], days_delta: int = 0
     ) -> Optional[date]:
@@ -128,6 +172,27 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
             name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+3
         )
 
+    def _add_chinese_new_years_day_five(self, name) -> Optional[date]:
+        """
+        Add Chinese New Year's Day Five.
+
+        https://en.wikipedia.org/wiki/Chinese_New_Year
+        """
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+4
+        )
+
+    def _add_dongzhi_festival(self, name) -> Optional[date]:
+        """
+        Add Dongzhi Festival (Chinese Winter Solstice).
+
+        The Dongzhi Festival or Winter Solstice Festival is a traditional
+        Chinese festival celebrated during the Dongzhi solar term
+        (winter solstice), which falls between December 21 and 23.
+        https://en.wikipedia.org/wiki/Dongzhi_Festival
+        """
+        return self._add_holiday(name, self._dongzhi_festival)
+
     def _add_qingming_festival(self, name) -> date:
         """
         Add Qingming Festival (15th day after the Spring Equinox).
@@ -136,7 +201,7 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
         Tomb-Sweeping Day in English, is a traditional Chinese festival.
         https://en.wikipedia.org/wiki/Qingming_Festival
         """
-        return self._add_holiday(name, self._qingming_date)
+        return self._add_holiday(name, self._qingming_festival)
 
     def _add_double_ninth_festival(self, name) -> Optional[date]:
         """