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

holidays/countries/yemen.py

@@ -13,22 +13,7 @@
 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,
-    THU,
-    FRI,
-    SAT,
-    _timedelta,
-)
+from holidays.calendars.gregorian import AUG, THU, FRI, SAT, _timedelta
 from holidays.constants import PUBLIC, SCHOOL, WORKDAY
 from holidays.groups import InternationalHolidays, IslamicHolidays
 from holidays.observed_holiday_base import ObservedHolidayBase, FRI_TO_NEXT_WORKDAY
@@ -156,52 +141,23 @@ class YEM(Yemen):
 
 class YemenIslamicHolidays(_CustomIslamicHolidays):
     # https://web.archive.org/web/20250115070635/https://www.timeanddate.com/holidays/yemen/eid-al-adha-first-day
-    EID_AL_ADHA_DATES = {
-        2020: (JUL, 31),
-        2021: (JUL, 20),
-        2022: (JUL, 9),
-        2023: (JUN, 28),
-        2024: (JUN, 16),
-    }
+
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2020, 2024)
 
     # https://web.archive.org/web/20250218061345/https://www.timeanddate.com/holidays/yemen/eid-al-fitr-first-day
-    EID_AL_FITR_DATES = {
-        2020: (MAY, 24),
-        2021: (MAY, 13),
-        2022: (MAY, 2),
-        2023: (APR, 21),
-        2024: (APR, 10),
-        2025: (MAR, 30),
-    }
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2020, 2025)
 
     # https://web.archive.org/web/20241011200213/https://www.timeanddate.com/holidays/yemen/muharram-new-year
+    HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (2020, 2024)
     HIJRI_NEW_YEAR_DATES = {
-        2020: (AUG, 20),
         2021: (AUG, 10),
-        2022: (JUL, 30),
-        2023: (JUL, 19),
-        2024: (JUL, 7),
     }
 
     # https://web.archive.org/web/20241010083000/https://www.timeanddate.com/holidays/yemen/isra-miraj
-    ISRA_AND_MIRAJ_DATES = {
-        2023: (FEB, 18),
-        2024: (FEB, 8),
-        2025: (JAN, 27),
-    }
+    ISRA_AND_MIRAJ_DATES_CONFIRMED_YEARS = (2023, 2025)
 
     # https://web.archive.org/web/20241010222331/https://www.timeanddate.com/holidays/yemen/prophet-birthday
-    MAWLID_DATES = {
-        2020: (OCT, 29),
-        2021: (OCT, 18),
-        2022: (OCT, 8),
-        2023: (SEP, 27),
-        2024: (SEP, 15),
-    }
+    MAWLID_DATES_CONFIRMED_YEARS = (2020, 2024)
 
     # https://web.archive.org/web/20250119111122/https://www.timeanddate.com/holidays/yemen/ramadan-begins
-    RAMADAN_BEGINNING_DATES = {
-        2023: (MAR, 23),
-        2024: (MAR, 11),
-        2025: (MAR, 1),
-    }
+    RAMADAN_BEGINNING_DATES_CONFIRMED_YEARS = (2023, 2025)

holidays/financial/__init__.py

@@ -15,4 +15,9 @@
 from holidays.financial.brasil_bolsa_balcao import BrasilBolsaBalcao, BVMF, B3
 from holidays.financial.european_central_bank import EuropeanCentralBank, XECB, ECB, TAR
 from holidays.financial.ice_futures_europe import ICEFuturesEurope, IFEU
+from holidays.financial.national_stock_exchange_of_india import (
+    NationalStockExchangeOfIndia,
+    XNSE,
+    NSE,
+)
 from holidays.financial.ny_stock_exchange import NewYorkStockExchange, XNYS, NYSE

holidays/financial/national_stock_exchange_of_india.py

@@ -0,0 +1,169 @@
+#  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 gettext import gettext as tr
+
+from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import MAR, APR, MAY, JUN, JUL, AUG
+from holidays.groups import ChristianHolidays, HinduCalendarHolidays, IslamicHolidays
+from holidays.observed_holiday_base import ObservedHolidayBase, SAT_TO_NONE, SUN_TO_NONE
+
+
+class NationalStockExchangeOfIndia(
+    ObservedHolidayBase, HinduCalendarHolidays, ChristianHolidays, IslamicHolidays
+):
+    """National Stock Exchange of India (NSE) holidays.
+
+    References:
+        * <https://web.archive.org/web/20250821175252/https://www.nseindia.com/resources/exchange-communication-circulars>
+
+    Historical data:
+        * [2022](https://web.archive.org/web/20250821071611/https://nsearchives.nseindia.com/content/circulars/CMTR50560.pdf)
+        * [2023](https://web.archive.org/web/20250821071635/https://nsearchives.nseindia.com/content/circulars/CMTR54757.pdf)
+        * [2024](https://web.archive.org/web/20250821071650/https://nsearchives.nseindia.com/content/circulars/CMTR59722.pdf)
+        * [2025](https://web.archive.org/web/20250624132016/https://nsearchives.nseindia.com/content/circulars/CMTR65587.pdf)
+    """
+
+    market = "XNSE"
+    default_language = "en_IN"
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
+    supported_languages = ("en_IN", "en_US", "hi")
+    start_year = 2001
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        ChristianHolidays.__init__(self)
+        HinduCalendarHolidays.__init__(self, cls=NationalStockExchangeOfIndiaHinduHolidays)
+        IslamicHolidays.__init__(
+            self,
+            cls=NationalStockExchangeOfIndiaIslamicHolidays,
+            show_estimated=islamic_show_estimated,
+        )
+        kwargs.setdefault("observed_rule", SAT_TO_NONE + SUN_TO_NONE)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Republic Day.
+        self._move_holiday(self._add_holiday_jan_26(tr("Republic Day")))
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Dr. Baba Saheb Ambedkar Jayanti.
+        self._move_holiday(self._add_holiday_apr_14(tr("Dr. Baba Saheb Ambedkar Jayanti")))
+
+        # Maharashtra Day.
+        self._move_holiday(self._add_holiday_may_1(tr("Maharashtra Day")))
+
+        # Independence Day.
+        self._move_holiday(self._add_holiday_aug_15(tr("Independence Day")))
+
+        # Mahatma Gandhi Jayanti.
+        self._move_holiday(self._add_holiday_oct_2(tr("Mahatma Gandhi Jayanti")))
+
+        # Christmas Day.
+        self._move_holiday(self._add_christmas_day(tr("Christmas Day")))
+
+        # Hindu Calendar Holidays.
+
+        # Maha Shivaratri.
+        self._move_holiday(self._add_maha_shivaratri(tr("Maha Shivaratri")))
+
+        # Holi.
+        self._move_holiday(self._add_holi(tr("Holi")))
+
+        # Ram Navami.
+        self._move_holiday(self._add_ram_navami(tr("Ram Navami")))
+
+        # Mahavir Jayanti.
+        self._move_holiday(self._add_mahavir_jayanti(tr("Mahavir Jayanti")))
+
+        # Ganesh Chaturthi.
+        self._move_holiday(self._add_ganesh_chaturthi(tr("Ganesh Chaturthi")))
+
+        # Dussehra.
+        self._move_holiday(self._add_dussehra(tr("Dussehra")))
+
+        # Diwali Laxmi Pujan.
+        self._move_holiday(self._add_gau_krida(tr("Diwali Laxmi Pujan")))
+
+        # Diwali Balipratipada.
+        name = tr("Diwali Balipratipada")
+        # NSE's calendar adds an extra-day gap in 2022–2023
+        # between Diwali Laxmi Pujan and Diwali Balipratipada.
+        self._move_holiday(
+            self._add_bhai_dooj(name)
+            if self._year in {2022, 2023}
+            else self._add_govardhan_puja(name)
+        )
+
+        # Guru Nanak Jayanti.
+        self._move_holiday(self._add_guru_nanak_jayanti(tr("Guru Nanak Jayanti")))
+
+        # Islamic Calendar Holidays.
+
+        # Ashura.
+        for dt in self._add_ashura_day(tr("Muharram")):
+            self._move_holiday(dt)
+
+        # Eid al-Fitr.
+        for dt in self._add_eid_al_fitr_day(tr("Id-Ul-Fitr (Ramadan Eid)")):
+            self._move_holiday(dt)
+
+        # Eid al-Adha.
+        for dt in self._add_eid_al_adha_day(tr("Bakri Id")):
+            self._move_holiday(dt)
+
+
+class XNSE(NationalStockExchangeOfIndia):
+    pass
+
+
+class NSE(NationalStockExchangeOfIndia):
+    pass
+
+
+class NationalStockExchangeOfIndiaHinduHolidays(_CustomHinduHolidays):
+    HOLI_DATES = {
+        2023: (MAR, 7),
+    }
+
+
+class NationalStockExchangeOfIndiaIslamicHolidays(_CustomIslamicHolidays):
+    ASHURA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    ASHURA_DATES = {
+        2022: (AUG, 9),
+        2023: (JUL, 29),
+        2024: (JUL, 17),
+        2025: (JUL, 6),
+    }
+
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_ADHA_DATES = {
+        2022: (JUL, 10),
+        2024: (JUN, 17),
+        2025: (JUN, 7),
+    }
+
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_FITR_DATES = {
+        2022: (MAY, 3),
+        2023: (APR, 22),
+        2024: (APR, 11),
+        2025: (MAR, 31),
+    }

holidays/groups/__init__.py

@@ -22,7 +22,9 @@ from holidays.groups.hebrew import HebrewCalendarHolidays
 from holidays.groups.hindu import HinduCalendarHolidays
 from holidays.groups.international import InternationalHolidays
 from holidays.groups.islamic import IslamicHolidays
+from holidays.groups.mandaean import MandaeanHolidays
 from holidays.groups.mongolian import MongolianCalendarHolidays
 from holidays.groups.persian import PersianCalendarHolidays
 from holidays.groups.sinhala import SinhalaCalendarHolidays
 from holidays.groups.thai import ThaiCalendarHolidays
+from holidays.groups.tibetan import TibetanCalendarHolidays

holidays/groups/christian.py

@@ -14,8 +14,9 @@ from datetime import date
 
 from dateutil.easter import EASTER_ORTHODOX, EASTER_WESTERN, easter
 
-from holidays.calendars.gregorian import GREGORIAN_CALENDAR, JAN, DEC, _timedelta
-from holidays.calendars.julian import JULIAN_CALENDAR
+from holidays.calendars.ethiopian import ETHIOPIAN_CALENDAR, is_ethiopian_leap_year
+from holidays.calendars.gregorian import GREGORIAN_CALENDAR, JAN, AUG, SEP, DEC, _timedelta
+from holidays.calendars.julian import JULIAN_CALENDAR, julian_calendar_drift
 from holidays.calendars.julian_revised import JULIAN_REVISED_CALENDAR
 
 
@@ -36,8 +37,8 @@ class ChristianHolidays:
         self.__verify_calendar(calendar)
 
         return (
-            date(self._year, JAN, 7)
-            if self.__is_julian_calendar(calendar)
+            _timedelta(date(self._year, JAN, 7), julian_calendar_drift(self._year - 1))
+            if self.__is_julian_calendar(calendar) or self.__is_ethiopian_calendar(calendar)
             else date(self._year, DEC, 25)
         )
 
@@ -53,6 +54,14 @@ class ChristianHolidays:
             method=EASTER_WESTERN if self.__is_gregorian_calendar(calendar) else EASTER_ORTHODOX,
         )
 
+    @staticmethod
+    def __is_ethiopian_calendar(calendar):
+        """
+        Return True if `calendar` is Ethiopian calendar.
+        Return False otherwise.
+        """
+        return calendar == ETHIOPIAN_CALENDAR
+
     @staticmethod
     def __is_gregorian_calendar(calendar):
         """
@@ -74,10 +83,15 @@ class ChristianHolidays:
         """
         Verify calendar type.
         """
-        if calendar not in {GREGORIAN_CALENDAR, JULIAN_CALENDAR, JULIAN_REVISED_CALENDAR}:
+        if calendar not in {
+            ETHIOPIAN_CALENDAR,
+            GREGORIAN_CALENDAR,
+            JULIAN_CALENDAR,
+            JULIAN_REVISED_CALENDAR,
+        }:
             raise ValueError(
-                f"Unknown calendar name: {calendar}. "
-                f"Use `{GREGORIAN_CALENDAR}`, `{JULIAN_CALENDAR}` or `{JULIAN_REVISED_CALENDAR}`."
+                f"Unknown calendar name: {calendar}. Use `{ETHIOPIAN_CALENDAR}`, "
+                f"`{GREGORIAN_CALENDAR}`, `{JULIAN_CALENDAR}` or `{JULIAN_REVISED_CALENDAR}`."
             )
 
     @property
@@ -158,7 +172,9 @@ class ChristianHolidays:
         self.__verify_calendar(calendar)
 
         return (
-            self._add_holiday_aug_28(name)
+            self._add_holiday(
+                name, _timedelta(date(self._year, AUG, 28), julian_calendar_drift(self._year))
+            )
             if self.__is_julian_calendar(calendar)
             else self._add_holiday_aug_15(name)
         )
@@ -299,10 +315,30 @@ class ChristianHolidays:
         calendar = calendar or self.__calendar
         self.__verify_calendar(calendar)
 
-        return (
-            self._add_holiday_jan_19(name)
-            if self.__is_julian_calendar(calendar)
-            else self._add_holiday_jan_6(name)
+        if self.__is_julian_calendar(calendar) or self.__is_ethiopian_calendar(calendar):
+            dt = _timedelta(date(self._year, JAN, 19), julian_calendar_drift(self._year - 1))
+            return self._add_holiday(
+                name,
+                _timedelta(dt, +1)
+                if self.__is_ethiopian_calendar(calendar)
+                and is_ethiopian_leap_year(self._year - 1)
+                else dt,
+            )
+        else:
+            return self._add_holiday_jan_6(name)
+
+    def _add_finding_of_true_cross(self, name) -> date:
+        """
+        Add Finding of True Cross.
+
+        Finding of True Cross, also known as Meskel, is an Ethiopian and Eritrean Orthodox
+        Tewahedo Church holiday that commemorates the discovery of the True Cross by the
+        Roman Empress Saint Helena of Constantinople in the fourth century.
+        https://en.wikipedia.org/wiki/Meskel
+        """
+        dt = _timedelta(date(self._year, SEP, 27), julian_calendar_drift(self._year))
+        return self._add_holiday(
+            name, _timedelta(dt, +1) if is_ethiopian_leap_year(self._year) else dt
         )
 
     def _add_good_friday(self, name, calendar=None) -> date:

holidays/groups/eastern.py

@@ -33,7 +33,7 @@ class EasternCalendarHolidays:
 
         Adds customizable estimation label to holiday name if holiday date is an estimation.
         """
-        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
+        estimated_label = getattr(self, "estimated_label", "%s")
         dt, is_estimated = dt_estimated
 
         if days_delta and dt:

holidays/groups/international.py

@@ -12,7 +12,9 @@
 
 from datetime import date
 
-from holidays.calendars.gregorian import JAN
+from holidays.calendars.ethiopian import is_ethiopian_leap_year
+from holidays.calendars.gregorian import JAN, SEP, _timedelta
+from holidays.calendars.julian import julian_calendar_drift
 
 
 class InternationalHolidays:
@@ -85,6 +87,20 @@ class InternationalHolidays:
         """
         return self._add_holiday_oct_12(name)
 
+    def _add_ethiopian_new_year(self, name) -> date:
+        """
+        Add Ethiopian New Year.
+
+        Ethiopian New Year, also known as Enkutatash, is a public holiday celebrated
+        on Meskerem 1 in the Ethiopian calendar, marking the start of the year in
+        Ethiopia and Eritrea.
+        https://en.wikipedia.org/wiki/Enkutatash
+        """
+        dt = _timedelta(date(self._year, SEP, 11), julian_calendar_drift(self._year))
+        return self._add_holiday(
+            name, _timedelta(dt, +1) if is_ethiopian_leap_year(self._year) else dt
+        )
+
     def _add_europe_day(self, name):
         """
         Add Europe Day (May 9th)

holidays/groups/islamic.py

@@ -374,7 +374,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         reflects the local interpretation and honor of the Prophet Muhammad.
         The term "baptism" is symbolic and not literal - there's no Islamic
         ritual akin to Christian baptism.
-        https://www.officeholidays.com/holidays/mali/prophets-baptism
+        https://web.archive.org/web/20240722052111/https://www.officeholidays.com/holidays/mali/prophets-baptism
         """
         return self._add_islamic_calendar_holiday(
             name, self._islamic_calendar.mawlid_dates(self._year), days_delta=+7

holidays/groups/mandaean.py

@@ -0,0 +1,107 @@
+#  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.gregorian import _timedelta
+from holidays.calendars.mandaean import _Mandaean
+
+
+class MandaeanHolidays:
+    """
+    Mandaean holidays.
+    """
+
+    def __init__(self) -> None:
+        self._mandaean = _Mandaean()
+
+    @property
+    def _dehwa_hanina(self):
+        return self._mandaean.mandaean_to_gregorian(self._year - 1, 9, 23)
+
+    @property
+    def _great_feast(self):
+        return self._mandaean.mandaean_to_gregorian(self._year, 1, 6)
+
+    @property
+    def _parwanaya(self):
+        return self._mandaean.mandaean_to_gregorian(self._year - 1, 13, 1)
+
+    def _add_mandaean_holiday(self, name: str, dt: Optional[date]) -> Optional[date]:
+        """
+        Add a Mandaean holiday.
+        """
+        if dt is None:
+            return None
+        return self._add_holiday(name, dt)
+
+    def _add_parwanaya_day(self, name) -> Optional[date]:
+        """
+        Add Parwanaya (Feast of Creation).
+        A major Mandaean holiday celebrated over five days after the 8th month.
+        The five intercalary days are considered as the 13th month.
+        Marks the creation of the world and renewal of life.
+        https://en.wikipedia.org/wiki/Parwanaya
+        """
+        return self._add_mandaean_holiday(name, self._parwanaya)
+
+    def _add_parwanaya_day_two(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._parwanaya, +1))
+
+    def _add_parwanaya_day_three(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._parwanaya, +2))
+
+    def _add_parwanaya_day_four(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._parwanaya, +3))
+
+    def _add_parwanaya_day_five(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._parwanaya, +4))
+
+    def _add_dehwa_daimana_day(self, name) -> Optional[date]:
+        """
+        Add Dehwa Daimana (Birthday of Prophet Yahya).
+        Celebrated on 1st day of Mandaean 11th month.
+        https://en.wikipedia.org/wiki/Dehwa_Daimana
+        """
+        return self._add_mandaean_holiday(
+            name, self._mandaean.mandaean_to_gregorian(self._year - 1, 11, 1)
+        )
+
+    def _add_dehwa_hanina_day(self, name) -> Optional[date]:
+        """
+        Add Dehwa Hanina (Little Feast / Day of Victory).
+        Commemorates spiritual triumph and deliverance.
+        Celebrated on 23rd day of the 9th Mandaean month.
+        https://en.wikipedia.org/wiki/Dehwa_Hanina
+        """
+        return self._add_mandaean_holiday(name, self._dehwa_hanina)
+
+    def _add_dehwa_hanina_day_two(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._dehwa_hanina, +1))
+
+    def _add_great_feast_day(self, name) -> Optional[date]:
+        """
+        Add Great Feast (Feast of the Great Shishlam).
+        Celebrated on the 6th day of the first month of the Mandaean calendar.
+        https://en.wikipedia.org/wiki/Feast_of_the_Great_Shishlam
+        """
+        return self._add_mandaean_holiday(name, self._great_feast)
+
+    def _add_great_feast_day_two(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._great_feast, +1))
+
+    def _add_great_feast_day_three(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._great_feast, +2))
+
+    def _add_great_feast_day_four(self, name) -> Optional[date]:
+        return self._add_mandaean_holiday(name, _timedelta(self._great_feast, +3))

holidays/groups/tibetan.py

@@ -0,0 +1,153 @@
+#  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 import _TibetanLunisolar
+from holidays.groups.eastern import EasternCalendarHolidays
+
+
+class TibetanCalendarHolidays(EasternCalendarHolidays):
+    """
+    Tibetan lunisolar calendar holidays.
+    """
+
+    def __init__(self, cls=None, show_estimated=False) -> None:
+        self._tibetan_calendar = cls() if cls else _TibetanLunisolar()
+        self._tibetan_calendar_show_estimated = show_estimated
+
+    def _add_tibetan_calendar_holiday(
+        self, name: str, dt_estimated: tuple[Optional[date], bool], days_delta: int = 0
+    ) -> Optional[date]:
+        """
+        Add Tibetan calendar holiday.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        return self._add_eastern_calendar_holiday(
+            name, dt_estimated, self._tibetan_calendar_show_estimated, days_delta
+        )
+
+    def _add_blessed_rainy_day(self, name) -> Optional[date]:
+        """
+        Add Blessed Rainy Day (September Equinox of Autumn Calendar).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.blessed_rainy_day_date(self._year)
+        )
+
+    def _add_birth_of_guru_rinpoche(self, name) -> Optional[date]:
+        """
+        Add Birth of Guru Rinpoche (10th day of the 5th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.birth_of_guru_rinpoche_date(self._year)
+        )
+
+    def _add_buddha_first_sermon(self, name) -> Optional[date]:
+        """
+        Add Buddha First Sermon (4th day of the 6th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.buddha_first_sermon_date(self._year)
+        )
+
+    def _add_buddha_parinirvana(self, name) -> Optional[date]:
+        """
+        Add Buddha Parinirvana (15th day of the 4th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.buddha_parinirvana_date(self._year)
+        )
+
+    def _add_day_of_offering(self, name) -> Optional[date]:
+        """
+        Add Day of Offering (1st day of the 12th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.day_of_offering_date(self._year)
+        )
+
+    def _add_death_of_zhabdrung(self, name) -> Optional[date]:
+        """
+        Add Death of Zhabdrung (10th day of the 3rd lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.death_of_zhabdrung_date(self._year)
+        )
+
+    def _add_descending_day_of_lord_buddha(self, name) -> Optional[date]:
+        """
+        Add Descending Day of Lord Buddha (22nd day of the 9th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.descending_day_of_lord_buddha_date(self._year)
+        )
+
+    def _add_losar(self, name) -> Optional[date]:
+        """
+        Add Losar (1st day of the 1st lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.losar_date(self._year)
+        )
+
+    def _add_losar_day_two(self, name) -> set[date]:
+        """
+        Add Losar Day Two.
+        """
+        dt = self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.losar_date(self._year), days_delta=+1
+        )
+        return {dt} if dt is not None else set()
+
+    def _add_thimphu_drubchen_day(self, name) -> Optional[date]:
+        """
+        Add Thimphu Drubchen (6th day of the 8th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.thimphu_drubchen_date(self._year), days_delta=+1
+        )
+
+    def _add_thimphu_tshechu_day(self, name) -> Optional[date]:
+        """
+        Add Thimphu Tshechu (10th day of the 8th lunar month).
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.thimphu_tshechu_date(self._year)
+        )
+
+    def _add_thimphu_tshechu_day_two(self, name) -> Optional[date]:
+        """
+        Add Thimphu Tshechu Day 2.
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.thimphu_tshechu_date(self._year), days_delta=+1
+        )
+
+    def _add_thimphu_tshechu_day_three(self, name) -> Optional[date]:
+        """
+        Add Thimphu Tshechu Day 3.
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.thimphu_tshechu_date(self._year), days_delta=+2
+        )
+
+    def _add_tibetan_winter_solstice(self, name) -> Optional[date]:
+        """
+        Add Winter Solstice Day.
+        """
+        return self._add_tibetan_calendar_holiday(
+            name, self._tibetan_calendar.tibetan_winter_solstice_date(self._year)
+        )