holidays 0.25__py3-none-any.whl → 0.27__py3-none-any.whl

holidays/financial/ny_stock_exchange.py

@@ -12,20 +12,20 @@
 from datetime import date
 from datetime import timedelta as td
 
-from dateutil.easter import easter
-
 from holidays.calendars import _get_nth_weekday_of_month
-from holidays.constants import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP
-from holidays.constants import OCT, NOV, DEC, MON, THU
+from holidays.constants import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC, MON, THU
 from holidays.holiday_base import HolidayBase
+from holidays.holiday_groups import ChristianHolidays, InternationalHolidays
 
 
-class NewYorkStockExchange(HolidayBase):
-    # Official regulations:
-    # https://www.nyse.com/publicdocs/nyse/regulation/nyse/NYSE_Rules.pdf
-    # https://www.nyse.com/markets/hours-calendars
-    # Historical data:
-    # s3.amazonaws.com/armstrongeconomics-wp/2013/07/NYSE-Closings.pdf
+class NewYorkStockExchange(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """
+    Official regulations:
+    - https://www.nyse.com/publicdocs/nyse/regulation/nyse/NYSE_Rules.pdf
+    - https://www.nyse.com/markets/hours-calendars
+    Historical data:
+    - s3.amazonaws.com/armstrongeconomics-wp/2013/07/NYSE-Closings.pdf
+    """
 
     market = "NYSE"
     special_holidays = {
@@ -43,21 +43,21 @@ class NewYorkStockExchange(HolidayBase):
             (OCT, 12, "Columbian Celebration"),
             (OCT, 21, "Columbian Celebration"),
         ),
-        1893: ((APR, 27, "Columbian Celebration"),),
-        1897: ((APR, 27, "Grant's Birthday"),),
-        1898: ((MAY, 4, "Charter Day"),),
+        1893: (APR, 27, "Columbian Celebration"),
+        1897: (APR, 27, "Grant's Birthday"),
+        1898: (MAY, 4, "Charter Day"),
         1899: (
             (MAY, 29, "Monday before Decoration Day"),
             (JUL, 3, "Monday before Independence Day"),
             (SEP, 29, "Admiral Dewey Celebration"),
         ),
-        1900: ((DEC, 24, "Christmas Eve"),),
+        1900: (DEC, 24, "Christmas Eve"),
         1901: (
             (JUL, 5, "Friday after Independence Day"),
             (SEP, 19, "Funeral of President McKinley"),
         ),
-        1903: ((APR, 22, "Opening of new NYSE building"),),
-        1917: ((JUN, 5, "Draft Registration Day"),),
+        1903: (APR, 22, "Opening of new NYSE building"),
+        1917: (JUN, 5, "Draft Registration Day"),
         1918: (
             (JAN, 28, "Heatless Day"),
             (FEB, 4, "Heatless Day"),
@@ -75,8 +75,8 @@ class NewYorkStockExchange(HolidayBase):
             (AUG, 3, "Death of President Warren G. Harding"),
             (AUG, 10, "Funeral of President Warren G. Harding"),
         ),
-        1927: ((JUN, 13, "Parade for Colonel Charles Lindbergh"),),
-        1929: ((NOV, 29, "Catch Up Day"),),
+        1927: (JUN, 13, "Parade for Colonel Charles Lindbergh"),
+        1929: (NOV, 29, "Catch Up Day"),
         1933: (
             (MAR, 6, "Special Bank Holiday"),
             (MAR, 7, "Special Bank Holiday"),
@@ -91,12 +91,12 @@ class NewYorkStockExchange(HolidayBase):
             (AUG, 16, "V-J Day (WWII)"),
             (DEC, 24, "Christmas Eve"),
         ),
-        1954: ((DEC, 24, "Christmas Eve"),),
-        1956: ((DEC, 24, "Christmas Eve"),),
-        1958: ((DEC, 26, "Day after Christmas"),),
-        1961: ((MAY, 29, "Day before Decoration Day"),),
-        1963: ((NOV, 25, "Funeral of President John F. Kennedy"),),
-        1965: ((DEC, 24, "Christmas Eve"),),
+        1954: (DEC, 24, "Christmas Eve"),
+        1956: (DEC, 24, "Christmas Eve"),
+        1958: (DEC, 26, "Day after Christmas"),
+        1961: (MAY, 29, "Day before Decoration Day"),
+        1963: (NOV, 25, "Funeral of President John F. Kennedy"),
+        1965: (DEC, 24, "Christmas Eve"),
         1968: (
             (APR, 9, "Day of Mourning for Martin Luther King Jr."),
             (JUL, 5, "Day after Independence Day"),
@@ -106,145 +106,139 @@ class NewYorkStockExchange(HolidayBase):
             (MAR, 31, "Funeral of President Dwight D. Eisenhower"),
             (JUL, 21, "National Participation in Lunar Exploration"),
         ),
-        1972: ((DEC, 28, "Funeral for President Harry S. Truman"),),
-        1973: ((JAN, 25, "Funeral for President Lyndon B. Johnson"),),
-        1977: ((JUL, 14, "Blackout in New Yor City"),),
-        1985: ((SEP, 27, "Hurricane Gloria"),),
-        1994: ((APR, 27, "Funeral for President Richard M. Nixon"),),
+        1972: (DEC, 28, "Funeral for President Harry S. Truman"),
+        1973: (JAN, 25, "Funeral for President Lyndon B. Johnson"),
+        1977: (JUL, 14, "Blackout in New Yor City"),
+        1985: (SEP, 27, "Hurricane Gloria"),
+        1994: (APR, 27, "Funeral for President Richard M. Nixon"),
         2001: (
             (SEP, 11, "Closed for Sept 11, 2001 Attacks"),
             (SEP, 12, "Closed for Sept 11, 2001 Attacks"),
             (SEP, 13, "Closed for Sept 11, 2001 Attacks"),
             (SEP, 14, "Closed for Sept 11, 2001 Attacks"),
         ),
-        2004: ((JUN, 11, "Day of Mourning for President Ronald W. Reagan"),),
-        2007: ((JAN, 2, "Day of Mourning for President Gerald R. Ford"),),
+        2004: (JUN, 11, "Day of Mourning for President Ronald W. Reagan"),
+        2007: (JAN, 2, "Day of Mourning for President Gerald R. Ford"),
         2012: (
             (OCT, 29, "Hurricane Sandy"),
             (OCT, 30, "Hurricane Sandy"),
         ),
-        2018: ((DEC, 5, "Day of Mourning for President George H.W. Bush"),),
+        2018: (DEC, 5, "Day of Mourning for President George H.W. Bush"),
     }
 
-    def _set_observed_date(self, holiday_date: date, name: str) -> None:
-        if self._is_saturday(holiday_date):
-            self[holiday_date + td(days=-1)] = name + " (Observed)"
-        elif self._is_sunday(holiday_date):
-            self[holiday_date + td(days=+1)] = name + " (Observed)"
-        else:
-            self[holiday_date] = name
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _add_observed_holiday(self, name: str, dt: date) -> None:
+        if self._is_saturday(dt):
+            dt += td(days=-1)
+            name = f"{name} (Observed)"
+        elif self._is_sunday(dt):
+            dt += td(days=+1)
+            name = f"{name} (Observed)"
+
+        self._add_holiday(name, dt)
 
     def _populate(self, year):
         super()._populate(year)
 
-        ##############################################################
-        # REGULAR HOLIDAYS
-        ##############################################################
-
-        # NYD
-        # This year's New Year Day.
+        # New Year Day.
         jan_1 = date(year, JAN, 1)
         if not self._is_saturday(jan_1):
-            self._set_observed_date(jan_1, "New Year's Day")
+            self._add_observed_holiday("New Year's Day", jan_1)
 
         # https://www.nyse.com/publicdocs/nyse/regulation/nyse/NYSE_Rules.pdf
         # As per Rule 7.2.: check if next year's NYD falls on Saturday and
         # needs to be observed on Friday (Dec 31 of previous year).
         dec_31 = date(year, DEC, 31)
         if self._is_friday(dec_31):
-            self._set_observed_date(dec_31 + td(days=+1), "New Year's Day")
+            self._add_observed_holiday("New Year's Day", dec_31 + td(days=+1))
 
-        # MLK - observed 1998 - 3rd Monday of Jan
+        # MLK, 3rd Monday of January.
         if year >= 1998:
-            self[
-                _get_nth_weekday_of_month(3, MON, JAN, year)
-            ] = "Martin Luther King Jr. Day"
+            self._add_holiday(
+                "Martin Luther King Jr. Day",
+                _get_nth_weekday_of_month(3, MON, JAN, year),
+            )
 
         # LINCOLN BIRTHDAY: observed 1896 - 1953 and 1968, Feb 12 (observed)
         if 1896 <= year <= 1953 or year == 1968:
-            self._set_observed_date(date(year, FEB, 12), "Lincoln's Birthday")
+            self._add_observed_holiday("Lincoln's Birthday", date(year, FEB, 12))
 
         # WASHINGTON'S BIRTHDAY: Feb 22 (obs) until 1971, then 3rd Mon of Feb
-        self._set_observed_date(
-            date(year, FEB, 22)
-            if year <= 1970
-            else _get_nth_weekday_of_month(3, MON, FEB, year),
+        self._add_observed_holiday(
             "Washington's Birthday",
+            date(year, FEB, 22) if year <= 1970 else _get_nth_weekday_of_month(3, MON, FEB, year),
         )
 
         # GOOD FRIDAY - closed every year except 1898, 1906, and 1907
         if year not in {1898, 1906, 1907}:
-            self[easter(year) + td(days=-2)] = "Good Friday"
+            self._add_good_friday("Good Friday")
 
         # MEM DAY (May 30) - closed every year since 1873
         # last Mon in May since 1971
         if year >= 1873:
-            self._set_observed_date(
+            self._add_observed_holiday(
+                "Memorial Day",
                 date(year, MAY, 30)
                 if year <= 1970
                 else _get_nth_weekday_of_month(-1, MON, MAY, year),
-                "Memorial Day",
             )
 
         # FLAG DAY: June 14th 1916 - 1953
         if 1916 <= year <= 1953:
-            self._set_observed_date(date(year, JUN, 14), "Flag Day")
+            self._add_observed_holiday("Flag Day", date(year, JUN, 14))
 
         # JUNETEENTH: since 2021
         if year >= 2021:
-            self._set_observed_date(
-                date(year, JUN, 19), "Juneteenth National Independence Day"
-            )
+            self._add_observed_holiday("Juneteenth National Independence Day", date(year, JUN, 19))
 
         # INDEPENDENCE DAY (July 4) - history suggests closed every year
-        self._set_observed_date(date(year, JUL, 4), "Independence Day")
+        self._add_observed_holiday("Independence Day", date(year, JUL, 4))
 
         # LABOR DAY - first mon in Sept, since 1887
         if year >= 1887:
-            self[_get_nth_weekday_of_month(1, MON, SEP, year)] = "Labor Day"
+            self._add_holiday("Labor Day", _get_nth_weekday_of_month(1, MON, SEP, year))
 
         # COLUMBUS DAY/INDIGENOUS PPL DAY: Oct 12 - closed 1909-1953
         if 1909 <= year <= 1953:
-            self._set_observed_date(date(year, OCT, 12), "Columbus Day")
+            self._add_observed_holiday("Columbus Day", date(year, OCT, 12))
 
         # ELECTION DAY: Tuesday after first Monday in November (2 U.S. Code §7)
         # closed until 1969, then closed pres years 1972-80
         if year <= 1968 or year in {1972, 1976, 1980}:
-            self[
-                _get_nth_weekday_of_month(1, MON, NOV, year) + td(days=+1)
-            ] = "Election Day"
+            self._add_holiday(
+                "Election Day",
+                _get_nth_weekday_of_month(1, MON, NOV, year) + td(days=+1),
+            )
 
         # VETERAN'S DAY: Nov 11 - closed 1918, 1921, 1934-1953
         if year in {1918, 1921} or 1934 <= year <= 1953:
-            self._set_observed_date(date(year, NOV, 11), "Veteran's Day")
+            self._add_observed_holiday("Veteran's Day", date(year, NOV, 11))
 
         # THXGIVING DAY: 4th Thurs in Nov - closed every year
-        self[_get_nth_weekday_of_month(4, THU, NOV, year)] = "Thanksgiving Day"
+        self._add_holiday("Thanksgiving Day", _get_nth_weekday_of_month(4, THU, NOV, year))
 
         # XMAS DAY: Dec 25th - every year
-        self._set_observed_date(date(year, DEC, 25), "Christmas Day")
+        self._add_observed_holiday("Christmas Day", date(year, DEC, 25))
 
-        ##############################################################
-        # SPECIAL HOLIDAYS
-        ##############################################################
+        # Special holidays.
         if year == 1914:
-            # Beginning of WWI
+            # Beginning of WWI.
             begin = date(year, JUL, 31)
             end = date(year, NOV, 27)
-            for dt in (
-                begin + td(days=n) for n in range((end - begin).days + 1)
-            ):
-                if self._is_weekend(dt) or self.get(dt):
+            for dt in (begin + td(days=n) for n in range((end - begin).days + 1)):
+                if self._is_weekend(dt) or dt in self:
                     continue
-                self[dt] = "World War I"
+                self._add_holiday("World War I", dt)
         elif year == 1968:
             begin = date(year, JUN, 12)
             end = date(year, DEC, 24)
-            # Wednesday special holiday
-            for dt in (
-                begin + td(days=n) for n in range(0, (end - begin).days + 1, 7)
-            ):
-                self[dt] = "Paper Crisis"
+            # Wednesday special holiday.
+            for dt in (begin + td(days=n) for n in range(0, (end - begin).days + 1, 7)):
+                self._add_holiday("Paper Crisis", dt)
 
 
 class XNYS(NewYorkStockExchange):

holidays/groups/__init__.py

@@ -0,0 +1,18 @@
+#  python-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: dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from holidays.groups.buddhist import BuddhistCalendarHolidays
+from holidays.groups.chinese import ChineseCalendarHolidays
+from holidays.groups.christian import ChristianHolidays
+from holidays.groups.hindu import HinduCalendarHolidays
+from holidays.groups.international import InternationalHolidays
+from holidays.groups.islamic import IslamicHolidays
+from holidays.groups.thai import ThaiCalendarHolidays

holidays/groups/buddhist.py

@@ -0,0 +1,71 @@
+#  python-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: dr-prodigy <maurizio.montel@gmail.com> (c) 2017-2022
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from typing import Tuple, Optional
+
+from holidays.calendars import _BuddhistLunisolar
+
+
+class BuddhistCalendarHolidays:
+    """
+    Buddhist lunisolar calendar holidays.
+    """
+
+    def __init__(self, calendar=_BuddhistLunisolar(), show_estimated=False) -> None:
+        self._buddhist_calendar = calendar
+        self._show_estimated = show_estimated
+
+    def _add_buddhist_calendar_holiday(
+        self,
+        name: str,
+        hol_date: Tuple[date, bool],
+    ) -> Optional[date]:
+        """
+        Add Buddhist calendar holiday.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        estimated_label = getattr(self, "estimated_label", "%s* (*estimated)")
+        dt, is_estimated = hol_date
+
+        return self._add_holiday(
+            self.tr(estimated_label) % self.tr(name)
+            if is_estimated and self._show_estimated
+            else name,
+            dt,
+        )
+
+    def _add_vesak(self, name) -> Optional[date]:
+        """
+        Add Vesak (15th day of the 4th lunar month).
+
+        Vesak for Thailand, Laos, Singapore and Indonesia.
+        https://en.wikipedia.org/wiki/Vesak
+        """
+        return self._add_buddhist_calendar_holiday(
+            name,
+            self._buddhist_calendar.vesak_date(self._year),
+        )
+
+    def _add_vesak_may(self, name) -> Optional[date]:
+        """
+        Add Vesak (on the day of the first full moon in May
+        in the Gregorian calendar).
+
+        Vesak for Sri Lanka, Nepal, India, Bangladesh and Malaysia.
+        https://en.wikipedia.org/wiki/Vesak
+        """
+        return self._add_buddhist_calendar_holiday(
+            name,
+            self._buddhist_calendar.vesak_may_date(self._year),
+        )

holidays/groups/chinese.py

@@ -0,0 +1,235 @@
+#  python-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: dr-prodigy <maurizio.montel@gmail.com> (c) 2017-2022
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from datetime import timedelta as td
+from typing import Tuple, Optional
+
+from holidays.calendars import _ChineseLunisolar
+from holidays.constants import APR
+
+
+class ChineseCalendarHolidays:
+    """
+    Chinese lunisolar calendar holidays.
+    """
+
+    def __init__(self, calendar=_ChineseLunisolar(), show_estimated=False) -> None:
+        self._chinese_calendar = calendar
+        self._show_estimated = show_estimated
+
+    @property
+    def _chinese_new_year(self):
+        """
+        Return Chinese New Year date.
+        """
+        return self._chinese_calendar.lunar_new_year_date(self._year)[0]
+
+    @property
+    def _qingming_date(self):
+        day = 5
+        if (self._year % 4 < 1) or (self._year % 4 < 2 and self._year >= 2009):
+            day = 4
+        return date(self._year, APR, day)
+
+    @property
+    def _mid_autumn_festival(self):
+        """
+        Return Mid Autumn Festival (15th day of the 8th lunar month) date.
+        """
+        return self._chinese_calendar.mid_autumn_date(self._year)[0]
+
+    def _add_chinese_calendar_holiday(
+        self,
+        name: str,
+        hol_date: Tuple[date, bool],
+        days_delta: int = 0,
+    ) -> Optional[date]:
+        """
+        Add Chinese calendar holiday.
+
+        Adds customizable estimation label to holiday name if holiday date
+        is an estimation.
+        """
+        estimated_label = getattr(self, "estimated_label", "%s* (*estimated)")
+        dt, is_estimated = hol_date
+        if days_delta != 0:
+            dt += td(days=days_delta)
+
+        return self._add_holiday(
+            self.tr(estimated_label) % self.tr(name)
+            if is_estimated and self._show_estimated
+            else name,
+            dt,
+        )
+
+    def _add_chinese_birthday_of_buddha(self, name) -> Optional[date]:
+        """
+        Add Birthday of the Buddha by Chinese lunar calendar (8th day of the
+        4th lunar month).
+
+        Birthday of the Buddha is a Buddhist festival that is celebrated in
+        most of East Asia and South Asia commemorating the birth of Gautama
+        Buddha, who was the founder of Buddhism.
+        https://en.wikipedia.org/wiki/Buddha%27s_Birthday
+        """
+        return self._add_chinese_calendar_holiday(
+            name,
+            self._chinese_calendar.buddha_birthday_date(self._year),
+        )
+
+    def _add_chinese_new_years_eve(self, name) -> Optional[date]:
+        """
+        Add Chinese New Year's Eve (last day of 12th lunar month).
+
+        Chinese New Year's Eve is the day before the Chinese New Year.
+        https://en.wikipedia.org/wiki/Chinese_New_Year%27s_Eve
+        """
+        return self._add_chinese_calendar_holiday(
+            name,
+            self._chinese_calendar.lunar_new_year_date(self._year),
+            days_delta=-1,
+        )
+
+    def _add_chinese_new_years_day(self, name) -> Optional[date]:
+        """
+        Add Chinese New Year's Day (first day of the first lunar month).
+
+        Chinese New Year is the festival that celebrates the beginning of
+        a new year on the traditional lunisolar and solar Chinese calendar.
+        https://en.wikipedia.org/wiki/Chinese_New_Year
+        """
+        return self._add_chinese_calendar_holiday(
+            name,
+            self._chinese_calendar.lunar_new_year_date(self._year),
+        )
+
+    def _add_chinese_new_years_day_two(self, name) -> Optional[date]:
+        """
+        Add Chinese New Year's Day Two.
+
+        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=+1,
+        )
+
+    def _add_chinese_new_years_day_three(self, name) -> Optional[date]:
+        """
+        Add Chinese New Year's Day Three.
+
+        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=+2,
+        )
+
+    def _add_chinese_new_years_day_four(self, name) -> Optional[date]:
+        """
+        Add Chinese New Year's Day Four.
+
+        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=+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_qingming_festival(self, name) -> date:
+        """
+        Add Qingming Festival (15th day after the Spring Equinox).
+
+        The Qingming festival or Ching Ming Festival, also known as
+        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)
+
+    def _add_double_ninth_festival(self, name) -> Optional[date]:
+        """
+        Add Double Ninth Festival (9th day of 9th lunar month).
+
+        The Double Ninth Festival (Chongyang Festival in Mainland China
+        and Taiwan or Chung Yeung Festival in Hong Kong and Macau).
+        https://en.wikipedia.org/wiki/Double_Ninth_Festival
+        """
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.double_ninth_date(self._year)
+        )
+
+    def _add_dragon_boat_festival(self, name) -> Optional[date]:
+        """
+        Add Dragon Boat Festival (5th day of 5th lunar month).
+
+        The Dragon Boat Festival is a traditional Chinese holiday which occurs
+        on the fifth day of the fifth month of the Chinese calendar.
+        https://en.wikipedia.org/wiki/Dragon_Boat_Festival
+        """
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.dragon_boat_date(self._year)
+        )
+
+    def _add_hung_kings_day(self, name) -> Optional[date]:
+        """
+        Add Hùng Kings' Temple Festival (10th day of the 3rd lunar month).
+
+        Vietnamese festival held annually from the 8th to the 11th day of the
+        3rd lunar month in honour of the Hùng Kings.
+        https://en.wikipedia.org/wiki/H%C3%B9ng_Kings%27_Festival
+        """
+        return self._add_chinese_calendar_holiday(
+            name,
+            self._chinese_calendar.hung_kings_date(self._year),
+        )
+
+    def _add_mid_autumn_festival(self, name) -> Optional[date]:
+        """
+        Add Mid Autumn Festival (15th day of the 8th lunar month).
+
+        The Mid-Autumn Festival, also known as the Moon Festival or
+        Mooncake Festival.
+        https://en.wikipedia.org/wiki/Mid-Autumn_Festival
+        """
+        return self._add_chinese_calendar_holiday(
+            name,
+            self._chinese_calendar.mid_autumn_date(self._year),
+        )
+
+    def _add_mid_autumn_festival_day_two(self, name) -> Optional[date]:
+        """
+        Add Mid Autumn Festival Day Two (16th day of the 8th lunar month).
+
+        The Mid-Autumn Festival, also known as the Moon Festival or
+        Mooncake Festival.
+        https://en.wikipedia.org/wiki/Mid-Autumn_Festival
+        """
+        return self._add_chinese_calendar_holiday(
+            name,
+            self._chinese_calendar.mid_autumn_date(self._year),
+            days_delta=+1,
+        )