holidays 0.80__py3-none-any.whl → 0.82__py3-none-any.whl

holidays/countries/tonga.py

@@ -10,8 +10,10 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
+from __future__ import annotations
+
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars.gregorian import SEP, NOV, DEC
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
@@ -22,6 +24,9 @@ from holidays.observed_holiday_base import (
     SUN_TO_NEXT_MON,
 )
 
+if TYPE_CHECKING:
+    from datetime import date
+
 
 class Tonga(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
     """Tonga holidays.

holidays/countries/trinidad_and_tobago.py

@@ -10,8 +10,10 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
+from __future__ import annotations
+
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
 from holidays.calendars.gregorian import MAR, APR, JUN, JUL, OCT, NOV
@@ -29,6 +31,9 @@ from holidays.observed_holiday_base import (
     WORKDAY_TO_NEXT_WORKDAY,
 )
 
+if TYPE_CHECKING:
+    from datetime import date
+
 
 class TrinidadAndTobago(
     ObservedHolidayBase,

holidays/countries/united_arab_emirates.py

@@ -10,7 +10,10 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from __future__ import annotations
+
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars import _CustomIslamicHolidays
 from holidays.calendars.gregorian import (
@@ -32,6 +35,9 @@ from holidays.constants import GOVERNMENT, OPTIONAL, PUBLIC
 from holidays.groups import InternationalHolidays, IslamicHolidays, StaticHolidays
 from holidays.holiday_base import HolidayBase
 
+if TYPE_CHECKING:
+    from datetime import date
+
 
 class UnitedArabEmirates(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays):
     """United Arab Emirates holidays.
@@ -79,11 +85,12 @@ class UnitedArabEmirates(HolidayBase, InternationalHolidays, IslamicHolidays, St
         StaticHolidays.__init__(self, UnitedArabEmiratesStaticHolidays)
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
+    def _get_weekend(self, dt: date) -> set[int]:
         # The resting days are Saturday and Sunday since Jan 1, 2022.
         # https://web.archive.org/web/20250216144205/https://time.com/6126260/uae-working-days-weekend/
-        self.weekend = {FRI, SAT} if self._year <= 2021 else {SAT, SUN}
+        return {SAT, SUN} if dt.year >= 2022 else {FRI, SAT}
 
+    def _populate_public_holidays(self):
         # New Year's Day.
         self._add_new_years_day(tr("رأس السنة الميلادية"))
 

holidays/countries/united_states.py

@@ -1341,6 +1341,22 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         # Saint Patrick's Day.
         self._add_holiday_mar_17(tr("Saint Patrick's Day"))
 
+        # Mother's Day.
+        # Starts to be observed by most US states by 1911.
+        # Officially proclaimed as a National Holiday by President Woodrow Wilson in 1914.
+
+        if self._year >= 1914:
+            # Mother's Day.
+            self._add_holiday_2nd_sun_of_may(tr("Mother's Day"))
+
+        # Father's Day.
+        # First founded in the state of Washington by Sonora Smart Dodd in 1910.
+        # Officially proclaimed as a National Holiday by President Richard Nixon in 1972.
+
+        if self._year >= 1972:
+            # Father's Day.
+            self._add_holiday_3rd_sun_of_jun(tr("Father's Day"))
+
         # Halloween.
         # Halloween began in the US sometime around the 19th century.
 

holidays/countries/uruguay.py

@@ -10,8 +10,10 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
+from __future__ import annotations
+
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars.gregorian import MAR
 from holidays.constants import BANK, PUBLIC
@@ -22,6 +24,9 @@ from holidays.observed_holiday_base import (
     THU_FRI_TO_NEXT_MON,
 )
 
+if TYPE_CHECKING:
+    from datetime import date
+
 
 class Uruguay(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
     """Uruguay holidays.

holidays/countries/vietnam.py

@@ -10,8 +10,10 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
+from __future__ import annotations
+
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars.chinese import VIETNAMESE_CALENDAR
 from holidays.calendars.gregorian import (
@@ -39,6 +41,9 @@ from holidays.observed_holiday_base import (
     SAT_SUN_TO_NEXT_WORKDAY,
 )
 
+if TYPE_CHECKING:
+    from datetime import date
+
 NATIONAL_DAY_RULE = ObservedRule({MON: +1, TUE: -1, WED: -1, THU: +1, FRI: -1, SAT: -1, SUN: +1})
 
 
@@ -54,6 +59,10 @@ class Vietnam(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHoliday
     """
 
     country = "VN"
+    # %s (estimated).
+    estimated_label = tr("%s (dự kiến)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (nghỉ bù, dự kiến)")
     # %s (observed).
     observed_label = tr("%s (nghỉ bù)")
     default_language = "vi"

holidays/countries/yemen.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from datetime import date
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
@@ -45,6 +46,7 @@ class Yemen(ObservedHolidayBase, InternationalHolidays, IslamicHolidays):
     start_year = 1991
     supported_categories = (PUBLIC, SCHOOL, WORKDAY)
     supported_languages = ("ar", "en_US")
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
         """
@@ -60,12 +62,13 @@ class Yemen(ObservedHolidayBase, InternationalHolidays, IslamicHolidays):
         kwargs.setdefault("observed_rule", FRI_TO_NEXT_WORKDAY)
         super().__init__(*args, **kwargs)
 
+    def _get_weekend(self, dt: date) -> set[int]:
+        # Yemen switches from THU-FRI to FRI-SAT on Aug 15, 2013.
+        return {FRI, SAT} if dt >= date(2013, AUG, 15) else {THU, FRI}
+
     def _populate_public_holidays(self):
         dts_observed = set()
 
-        # Yemen switches from THU-FRI to FRI-SAT on Aug 15, 2013
-        self.weekend = {THU, FRI} if self._year <= 2012 else {FRI, SAT}
-
         # Hijri New Year.
         dts_observed.update(self._add_islamic_new_year_day(tr("عيد رأس السنة الهجرية")))
 

holidays/groups/__init__.py

@@ -14,6 +14,7 @@
 
 from holidays.groups.balinese_saka import BalineseSakaCalendarHolidays
 from holidays.groups.buddhist import BuddhistCalendarHolidays
+from holidays.groups.burmese import BurmeseCalendarHolidays
 from holidays.groups.chinese import ChineseCalendarHolidays
 from holidays.groups.christian import ChristianHolidays
 from holidays.groups.custom import StaticHolidays

holidays/groups/balinese_saka.py

@@ -13,7 +13,7 @@
 from datetime import date
 from typing import Optional
 
-from holidays.calendars import _BalineseSakaLunar
+from holidays.calendars.balinese_saka import _BalineseSakaLunar
 
 
 class BalineseSakaCalendarHolidays:

holidays/groups/buddhist.py

@@ -13,7 +13,7 @@
 from datetime import date
 from typing import Optional
 
-from holidays.calendars import _BuddhistLunisolar
+from holidays.calendars.buddhist import _BuddhistLunisolar
 from holidays.groups.eastern import EasternCalendarHolidays
 
 

holidays/groups/burmese.py

@@ -0,0 +1,273 @@
+#  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 CONTRIBUTORS 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.burmese import _BurmeseLunisolar
+from holidays.calendars.gregorian import _timedelta
+
+
+class BurmeseCalendarHolidays:
+    """Burmese lunisolar calendar holidays."""
+
+    def __init__(self) -> None:
+        self._burmese_calendar = _BurmeseLunisolar()
+
+    def _add_burmese_calendar_holiday(
+        self, name: str, dt: Optional[date] = None, days_delta: int = 0
+    ) -> Optional[date]:
+        """Add Burmese calendar holiday."""
+
+        if dt is None:
+            return None
+
+        if days_delta:
+            dt = _timedelta(dt, days_delta)
+
+        return self._add_holiday(name, dt)
+
+    def _add_karen_new_year(self, name: str) -> set[date]:
+        """Add Karen New Year holiday.
+
+        The Karen New Year, also known as the Kayin New Year, is one of the major holidays
+        celebrated by the Karen people. The Karen New Year falls on the first day of Pyatho,
+        the tenth month in the Burmese calendar.
+        https://en.wikipedia.org/wiki/Karen_New_Year
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Set of dates of added holiday, empty if there is no holiday date for the current year.
+        """
+        return {
+            dt
+            for y in (self._year - 1, self._year)
+            if (
+                dt := self._add_burmese_calendar_holiday(
+                    name, self._burmese_calendar.pyatho_waxing_moon_date(y)
+                )
+            )
+        }
+
+    def _add_kason_full_moon_day(self, name: str) -> Optional[date]:
+        """Add Full Moon Day of Kason holiday.
+
+        Vesak is known as the Full Moon Day of Kason, which is the second month
+        in the traditional Burmese calendar.
+        https://en.wikipedia.org/wiki/Vesak#In_Myanmar_(Burma)
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.kason_full_moon_date(self._year)
+        )
+
+    def _add_myanmar_diwali(self, name: str) -> Optional[date]:
+        """Add Myanmar Diwali holiday.
+
+        Diwali (Deepavali, Festival of Lights) is one of the most important festivals
+        in Indian religions. In Myanmar, it is celebrated on first day of Tazaungmon,
+        the eighth month of the Burmese calendar.
+        https://en.wikipedia.org/wiki/Diwali
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.tazaungmon_waxing_moon_date(self._year)
+        )
+
+    def _add_myanmar_national_day(self, name: str) -> Optional[date]:
+        """Add Myanmar National Day holiday.
+
+        National Day is a public holiday in Myanmar, marking the anniversary of the first
+        university student strike at Rangoon University in 1920. The date is based on
+        the traditional Burmese calendar, occurring on the 10th day following
+        the full moon of Tazaungmon.
+        https://en.wikipedia.org/wiki/National_Day_(Myanmar)
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.tazaungmon_full_moon_date(self._year), days_delta=+10
+        )
+
+    def _add_myanmar_new_year(
+        self,
+        name: str,
+        extra_days_before: int = 0,
+        extra_days_after: int = 0,
+    ) -> set[date]:
+        """Add Myanmar New Year (Thingyan, Water Festival).
+
+        Thingyan, also known as the Myanmar New Year, is a festival that usually occurs
+        in middle of April. Thingyan marks the transition from the old year to the new one,
+        based on the traditional Myanmar lunisolar calendar. The festival usually spans
+        four to five days.
+
+        https://en.wikipedia.org/wiki/Thingyan.
+
+        Args:
+            name:
+                Holiday name.
+
+            extra_days_before:
+                Number of additional holiday days preceding Akya.
+
+            extra_days_after:
+                Whether to add additional holiday days following Atat.
+
+        Returns:
+            Set of dates of added holiday, empty if there is no holiday date for the current year.
+        """
+        akya, atat = self._burmese_calendar.thingyan_dates(self._year)
+        if akya is None or atat is None:
+            return set()
+
+        # Default length is from Thingyan Akyo (akya - 1) to New Year Day (atat + 1).
+        # Optional additional days:
+        # pre-Akya days (1 day in 2007-2016, 4 days in 2022-2023),
+        # post-Atat days (3 or 4 days).
+        begin = -1 - extra_days_before
+        end = extra_days_after or (atat - akya).days + 1
+
+        return {
+            dt
+            for delta in range(begin, end)
+            if (dt := self._add_holiday(name, _timedelta(akya, delta)))
+        }
+
+    def _add_tabaung_full_moon_day(self, name: str) -> Optional[date]:
+        """Add Full Moon Day of Tabaung holiday.
+
+        Māgha Pūjā (also written as Makha Bucha Day, Meak Bochea) is a Buddhist festival
+        celebrated on the full moon day of Tabaung in Myanmar.
+        https://en.wikipedia.org/wiki/Māgha_Pūjā#Myanmar_(Burma)
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.tabaung_full_moon_date(self._year - 1)
+        )
+
+    def _add_tazaungmon_full_moon_day(self, name: str) -> Optional[date]:
+        """Add Full Moon Day of Tazaungmon holiday.
+
+        The Tazaungdaing Festival, also known as the Festival of Lights, held on the full moon day
+        of Tazaungmon, the eighth month of the Burmese calendar.
+        https://en.wikipedia.org/wiki/Tazaungdaing_festival
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.tazaungmon_full_moon_date(self._year)
+        )
+
+    def _add_thadingyut_full_moon_eve(self, name: str) -> Optional[date]:
+        """Add Pre-Full Moon Day of Thadingyut holiday.
+
+        The Thadingyut Festival, also known as the Lighting Festival of Myanmar, is held
+        on the full moon day of the Burmese lunar month of Thadingyut.
+        https://en.wikipedia.org/wiki/Thadingyut_Festival
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.thadingyut_full_moon_date(self._year), days_delta=-1
+        )
+
+    def _add_thadingyut_full_moon_day(self, name: str) -> Optional[date]:
+        """Add Full Moon Day of Thadingyut holiday.
+
+        The Thadingyut Festival, also known as the Lighting Festival of Myanmar, is held
+        on the full moon day of the Burmese lunar month of Thadingyut.
+        https://en.wikipedia.org/wiki/Thadingyut_Festival
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.thadingyut_full_moon_date(self._year)
+        )
+
+    def _add_thadingyut_full_moon_day_two(self, name: str) -> Optional[date]:
+        """Add Post-Full Moon Day of Thadingyut holiday.
+
+        The Thadingyut Festival, also known as the Lighting Festival of Myanmar, is held
+        on the full moon day of the Burmese lunar month of Thadingyut.
+        https://en.wikipedia.org/wiki/Thadingyut_Festival
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.thadingyut_full_moon_date(self._year), days_delta=+1
+        )
+
+    def _add_waso_full_moon_day(self, name: str) -> Optional[date]:
+        """Add Full Moon Day of Waso holiday.
+
+        Vassa is the three-month annual retreat observed by Theravada Buddhists.
+        Vassa lasts for three lunar months, from the Burmese month of Waso to
+        the Burmese month of Thadingyut.
+        https://en.wikipedia.org/wiki/Vassa
+
+        Args:
+            name:
+                Holiday name.
+
+        Returns:
+            Date of added holiday, `None` if there is no holiday date for the current year.
+        """
+        return self._add_burmese_calendar_holiday(
+            name, self._burmese_calendar.waso_full_moon_date(self._year)
+        )

holidays/groups/chinese.py

@@ -14,7 +14,7 @@ from datetime import date
 from typing import Optional
 
 from holidays.calendars.chinese import _ChineseLunisolar, CHINESE_CALENDAR
-from holidays.calendars.gregorian import APR, DEC
+from holidays.calendars.gregorian import APR
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -79,20 +79,8 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
     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)
+        return self._chinese_calendar.winter_solstice_date(self._year)[0]
 
     def _add_chinese_calendar_holiday(
         self, name: str, dt_estimated: tuple[Optional[date], bool], days_delta: int = 0
@@ -195,6 +183,18 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
             name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+4
         )
 
+    def _add_daeboreum_day(self, name) -> Optional[date]:
+        """
+        Add Daeboreum Day (15th day of 1st lunar month).
+
+        Daeboreum is a Korean holiday that celebrates the first full moon
+        of the new year of the lunar Korean calendar.
+        https://en.wikipedia.org/wiki/Daeboreum
+        """
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+14
+        )
+
     def _add_dongzhi_festival(self, name) -> Optional[date]:
         """
         Add Dongzhi Festival (Chinese Winter Solstice).
@@ -206,6 +206,19 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
         """
         return self._add_holiday(name, self._dongzhi_festival)
 
+    def _add_hanshi_festival(self, name) -> Optional[date]:
+        """
+        Add Hanshi Festival (105 days after Winter Solstice).
+
+        The Cold Food or Hanshi Festival is a traditional Chinese holiday. Its name
+        derives from the tradition of avoiding the lighting of any kind of fire,
+        even for the preparation of food.
+        https://en.wikipedia.org/wiki/Cold_Food_Festival
+        """
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.winter_solstice_date(self._year - 1), days_delta=+105
+        )
+
     def _add_qingming_festival(self, name) -> date:
         """
         Add Qingming Festival (15th day after the Spring Equinox).

holidays/groups/custom.py

@@ -31,17 +31,23 @@ class StaticHolidays:
                 setattr(self, attribute_name, value)
                 self.has_special_holidays = True
 
-            # Substituted holidays.
+            # "Substituted" labels.
             elif attribute_name.startswith("substituted_") and (
                 value := getattr(cls, attribute_name, None)
             ):
                 setattr(self, attribute_name, value)
-                self.has_substituted_holidays = True
 
         # Populate substituted holidays from adjacent years.
         self.weekend_workdays = set()
         for special_public_holidays in getattr(self, "special_public_holidays", {}).values():
             for special_public_holiday in _normalize_tuple(special_public_holidays):
+                # Normally, special holiday is a 3 item tuple: (month, day, name).
+                if len(special_public_holiday) < 4:  # Skip non-substituted holidays.
+                    continue
+
+                # Handle cross-year substituted holidays.
                 if len(special_public_holiday) == 5:  # The fifth element is the year.
                     _, _, from_month, from_day, from_year = special_public_holiday
                     self.weekend_workdays.add(date(from_year, from_month, from_day))
+
+                self.has_substituted_holidays = True

holidays/groups/eastern.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from collections.abc import Iterable
 from datetime import date
 from typing import Optional
 
@@ -33,15 +34,13 @@ class EasternCalendarHolidays:
 
         Adds customizable estimation label to holiday name if holiday date is an estimation.
         """
-        estimated_label = getattr(self, "estimated_label", "%s")
         dt, is_estimated = dt_estimated
-
         if days_delta and dt:
             dt = _timedelta(dt, days_delta)
 
         return (
             self._add_holiday(
-                self.tr(estimated_label) % self.tr(name)
+                self.tr(self.estimated_label) % self.tr(name)
                 if is_estimated and show_estimated
                 else name,
                 dt,
@@ -49,3 +48,26 @@ class EasternCalendarHolidays:
             if dt
             else None
         )
+
+    def _add_eastern_calendar_holiday_set(
+        self,
+        name: str,
+        dts_estimated: Iterable[tuple[date, bool]],
+        show_estimated: bool = True,
+        days_delta: int = 0,
+    ) -> set[date]:
+        """
+        Add Eastern (Buddhist, Chinese, Hindu, Islamic, Mongolian) calendar holidays.
+
+        Adds customizable estimation label to holiday name if holiday date is an estimation.
+        """
+
+        return {
+            dt
+            for dt_estimated in dts_estimated
+            if (
+                dt := self._add_eastern_calendar_holiday(
+                    name, dt_estimated, show_estimated, days_delta
+                )
+            )
+        }