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

holidays/calendars/chinese.py

@@ -14,7 +14,7 @@ from datetime import date
 from typing import Optional
 
 from holidays.calendars.custom import _CustomCalendar
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, SEP, OCT, NOV
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, SEP, OCT, NOV, DEC
 
 CHINESE_CALENDAR = "CHINESE_CALENDAR"
 KOREAN_CALENDAR = "KOREAN_CALENDAR"
@@ -1307,6 +1307,24 @@ class _ChineseLunisolar:
         2053: (FEB, 18),
     }
 
+    WINTER_SOLSTICE_THRESHOLDS: dict[str, dict[str, dict[int, int]]] = {
+        # UTC+7.
+        VIETNAMESE_CALENDAR: {
+            "dec_21": {0: 1980, 1: 2017, 2: 2050, 3: 2083},
+            "dec_23": {3: 1943},
+        },
+        # UTC+8.
+        CHINESE_CALENDAR: {
+            "dec_21": {0: 1988, 1: 2021, 2: 2058, 3: 2091},
+            "dec_23": {3: 1947},
+        },
+        # UTC+9.
+        KOREAN_CALENDAR: {
+            "dec_21": {0: 1992, 1: 2029, 2: 2062, 3: 2099},
+            "dec_23": {3: 1955},
+        },
+    }
+
     def __init__(self, calendar: str = CHINESE_CALENDAR) -> None:
         self.__verify_calendar(calendar)
         self.__calendar = calendar
@@ -1359,6 +1377,26 @@ class _ChineseLunisolar:
     def mid_autumn_date(self, year: int, calendar=None) -> tuple[Optional[date], bool]:
         return self._get_holiday(MID_AUTUMN, year, calendar)
 
+    def winter_solstice_date(self, year: int, calendar=None) -> tuple[Optional[date], bool]:
+        """Return Winter Solstice (22nd solar term in Chinese Lunisolar calendar) date.
+
+        !!! note "Note"
+            This approximation is reliable for 1941-2099 years.
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        thresholds = self.WINTER_SOLSTICE_THRESHOLDS[calendar]
+        year_mod = year % 4
+        if year >= thresholds["dec_21"][year_mod]:
+            day = 21
+        elif year <= thresholds["dec_23"].get(year_mod, 0):
+            day = 23
+        else:
+            day = 22
+
+        return date(year, DEC, day), not (1941 <= year <= 2099)
+
 
 class _CustomChineseHolidays(_CustomCalendar, _ChineseLunisolar):
     pass

holidays/countries/__init__.py

@@ -196,6 +196,11 @@ from holidays.countries.romania import Romania, RO, ROU
 from holidays.countries.russia import Russia, RU, RUS
 from holidays.countries.rwanda import Rwanda, RW, RWA
 from holidays.countries.saint_barthelemy import SaintBarthelemy, BL, BLM, HolidaysBL
+from holidays.countries.saint_helena_ascension_and_tristan_da_cunha import (
+    SaintHelenaAscensionAndTristanDaCunha,
+    SH,
+    SHN,
+)
 from holidays.countries.saint_kitts_and_nevis import SaintKittsAndNevis, KN, KNA
 from holidays.countries.saint_lucia import SaintLucia, LC, LCA
 from holidays.countries.saint_martin import SaintMartin, MF, MAF, HolidaysMF
@@ -234,6 +239,7 @@ from holidays.countries.south_korea import SouthKorea, KR, KOR, Korea
 from holidays.countries.south_sudan import SouthSudan, SS, SSD
 from holidays.countries.spain import Spain, ES, ESP
 from holidays.countries.sri_lanka import SriLanka, LK, LKA
+from holidays.countries.sudan import Sudan, SD, SDN
 from holidays.countries.suriname import Suriname, SR, SUR
 from holidays.countries.svalbard_and_jan_mayen import SvalbardAndJanMayen, SJ, SJM, HolidaysSJ
 from holidays.countries.sweden import Sweden, SE, SWE

holidays/countries/china.py

@@ -65,6 +65,10 @@ class China(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays,
     """
 
     country = "CN"
+    # %s (estimated).
+    estimated_label = tr("%s（推定）")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s（观察日，推定）")
     # %s (observed).
     observed_label = tr("%s（观察日）")
     supported_categories = (PUBLIC, HALF_DAY)

holidays/countries/hongkong.py

@@ -69,8 +69,12 @@ class HongKong(
     country = "HK"
     default_language = "zh_HK"
     default_preferred_discretionary_holidays = (CHRISTMAS,)
+    # %s (estimated).
+    estimated_label = tr("%s（推定）")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s（補假，推定）")
     # %s (observed).
-    observed_label = tr("%s（慶祝）")
+    observed_label = tr("%s（補假）")
     supported_categories = (OPTIONAL, PUBLIC)
     supported_languages = ("en_HK", "en_US", "th", "zh_CN", "zh_HK")
     weekend = {SUN}

holidays/countries/macau.py

@@ -62,6 +62,8 @@ class Macau(
 
     country = "MO"
     default_language = "zh_MO"
+    # %s (estimated).
+    estimated_label = tr("%s（推定）")
     # Decreto-Lei n.º 4/82/M.
     start_year = 1982
     subdivisions = (
@@ -374,6 +376,13 @@ class Macau(
                 # The first working day after %s.
                 else self.tr("%s後首個工作日")
             )
+            self.observed_estimated_label = (
+                # Compensatory rest day for %s (estimated).
+                self.tr("%s的補假（推定）")
+                if self._year >= 2020
+                # The first working day after %s (estimated).
+                else self.tr("%s後首個工作日（推定）")
+            )
             # Prior to 2012, in-lieus are only given for holidays which falls on Sunday.
             self._observed_rule = (
                 SUN_TO_NEXT_WORKDAY if self._year <= 2011 else SAT_SUN_TO_NEXT_WORKDAY

holidays/countries/mongolia.py

@@ -32,6 +32,8 @@ class Mongolia(HolidayBase, InternationalHolidays, MongolianCalendarHolidays):
 
     country = "MN"
     default_language = "mn"
+    # %s (estimated).
+    estimated_label = tr("%s (урьдчилсан)")
     start_year = 2004
     supported_categories = (PUBLIC, WORKDAY)
     supported_languages = ("en_US", "mn")

holidays/countries/philippines.py

@@ -53,6 +53,7 @@ class Philippines(
         * [Proclamation No. 839/2025](https://archive.org/details/20250320-proc-839-frm_202506)
         * [Proclamation No. 878/2025](https://archive.org/details/20250506-proc-878-frm_202506)
         * [Proclamation No. 911/2025](https://archive.org/details/20250521-proc-911-frm_20250606_1800)
+        * [Proclamation No. 1006/2025](https://archive.org/details/20250903-proc-1006-frm)
     """
 
     country = "PH"
@@ -240,9 +241,13 @@ class PhilippinesIslamicHolidays(_CustomIslamicHolidays):
 class PhilippinesStaticHolidays:
     # Additional special (non-working) day.
     additional_special = tr("Additional special (non-working) day")
+
     # Elections special (non-working) day.
     election_special = tr("Elections special (non-working) day")
 
+    # Christmas Eve.
+    christmas_eve = tr("Christmas Eve")
+
     special_public_holidays = {
         2008: (
             (DEC, 26, additional_special),
@@ -309,7 +314,11 @@ class PhilippinesStaticHolidays:
             (JUL, 27, additional_special),
             # All Saints' Day Eve.
             (OCT, 31, tr("All Saints' Day Eve")),
-            # Christmas Eve.
-            (DEC, 24, tr("Christmas Eve")),
+            (DEC, 24, christmas_eve),
+        ),
+        2026: (
+            # All Souls' Day.
+            (NOV, 2, tr("All Souls' Day")),
+            (DEC, 24, christmas_eve),
         ),
     }

holidays/countries/saint_helena_ascension_and_tristan_da_cunha.py

@@ -0,0 +1,197 @@
+#  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.gregorian import JAN, FEB, APR, MAY, JUN, SEP
+from holidays.constants import GOVERNMENT, PUBLIC
+from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    SAT_TO_PREV_FRI,
+    SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON_TUE,
+)
+
+
+class SaintHelenaAscensionAndTristanDaCunha(
+    ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays
+):
+    """Saint Helena, Ascension and Tristan da Cunha holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Saint_Helena,_Ascension_and_Tristan_da_Cunha>
+
+    Saint Helena:
+        * <https://web.archive.org/web/20250810194916/https://sainthelenaisland.info/holidays.htm>
+        * [Public Holidays Ordinance](https://web.archive.org/web/20231129081100/https://www.sainthelena.gov.sh/wp-content/uploads/2013/01/Public-Holidays-Ordinance.pdf)
+        * [2015](https://web.archive.org/web/20241219152350/https://www.sainthelena.gov.sh/wp-content/uploads/2012/08/Public-Holidays-2015.pdf)
+        * [2020](https://web.archive.org/web/20250831203105/https://www.sainthelena.gov.sh/wp-content/uploads/2019/11/Public-Holidays-2020.pdf)
+        * [2021](https://web.archive.org/web/20240626101426/https://www.sainthelena.gov.sh/wp-content/uploads/2020/08/200824_Public-Holidays-2021.pdf)
+        * [2022](https://web.archive.org/web/20230922215102/https://www.sainthelena.gov.sh/wp-content/uploads/2021/11/PUBLIC-HOLIDAYS-2022.pdf)
+        * [Saint Helena Day 2023](https://web.archive.org/web/20250519085755/https://www.sainthelena.gov.sh/wp-content/uploads/2022/09/EX-GAZ-100-Proclamation-St-Helena-Day-2023.pdf)
+        * [2024](https://web.archive.org/web/20250614201000/https://www.sainthelena.gov.sh/2023/news/public-and-government-holidays-2024/)
+        * [2025](https://web.archive.org/web/20241005191212/https://www.sainthelena.gov.sh/wp-content/uploads/2024/08/Public-Notice-Public-Holidays-2025.pdf)
+        * [2026](https://web.archive.org/web/20250831200128/https://www.sainthelena.gov.sh/wp-content/uploads/2025/08/Public-Notice-Public-Holidays-2026.pdf)
+
+    Ascension:
+        * [Public Holidays Ordinance](https://web.archive.org/web/20240610184146/https://www.sainthelena.gov.sh/wp-content/uploads/2017/12/Public-Holidays-Asc-Ordinance.pdf)
+
+    Tristan da Cunha:
+        * [Ratting Day](https://web.archive.org/web/20250826151056/https://www.tristandc.com/newsratting.php)
+    """
+
+    country = "SH"
+    default_language = "en_GB"
+    # %s (observed).
+    observed_label = tr("%s (observed)")
+    # Earliest year of holidays with an accessible online record.
+    start_year = 2015
+    subdivisions = (
+        "AC",  # Ascension.
+        "HL",  # Saint Helena.
+        "TA",  # Tristan da Cunha.
+    )
+    subdivisions_aliases = {
+        "Ascension": "AC",
+        "Saint Helena": "HL",
+        "Tristan da Cunha": "TA",
+    }
+    supported_categories = (GOVERNMENT, PUBLIC)
+    supported_languages = ("en_GB", "en_US")
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, cls=SaintHelenaAscensionAndTristanDaCunhaStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Easter Monday"))
+
+        if self._year <= 2022:
+            # Queen's Birthday.
+            name = tr("Queen's Birthday")
+            if self._year <= 2019:
+                self._add_holiday_3rd_mon_of_jun(name)
+            else:
+                self._add_holiday_2nd_mon_of_jun(name)
+        else:
+            # King's Birthday.
+            name = tr("King's Birthday")
+            if self._year == 2023:
+                self._add_holiday_jun_19(name)
+            else:
+                self._add_holiday_1st_fri_from_nov_11(name)
+
+        self._add_observed(
+            # Christmas Day.
+            self._add_christmas_day(tr("Christmas Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE,
+        )
+
+        self._add_observed(
+            # Boxing Day.
+            self._add_christmas_day_two(tr("Boxing Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE,
+        )
+
+    def _populate_subdiv_ac_public_holidays(self):
+        # Ascension Day.
+        self._add_ascension_thursday(tr("Ascension Day"))
+
+    def _populate_subdiv_hl_public_holidays(self):
+        self._add_observed(
+            # Saint Helena Day.
+            self._add_holiday_may_21(tr("Saint Helena Day")),
+            rule=SAT_TO_PREV_FRI + SUN_TO_NEXT_MON,
+        )
+
+    def _populate_subdiv_ta_public_holidays(self):
+        # Ascension Day.
+        self._add_ascension_thursday(tr("Ascension Day"))
+
+        ratting_day_dates = {
+            2015: (MAY, 16),
+            2016: (APR, 30),
+            2017: (MAY, 26),
+            2018: (JUN, 2),
+            2019: (MAY, 24),
+            2020: (APR, 25),
+            2021: (APR, 9),
+            2023: (JUN, 2),
+            2025: (MAY, 30),
+        }
+        # Ratting Day.
+        name = tr("Ratting Day")
+        if dt := ratting_day_dates.get(self._year):
+            self._add_holiday(name, dt)
+
+        # Anniversary Day.
+        self._add_holiday_aug_14(tr("Anniversary Day"))
+
+    def _populate_government_holidays(self):
+        # New Year's Day.
+        self._add_observed(self._add_new_years_day(tr("New Year's Day")))
+
+        # Whit Monday.
+        self._add_whit_monday(tr("Whit Monday"))
+
+    def _populate_subdiv_ac_government_holidays(self):
+        # August Bank Holiday.
+        self._add_holiday_last_mon_of_aug(tr("August Bank Holiday"))
+
+    def _populate_subdiv_hl_government_holidays(self):
+        # August Bank Holiday.
+        self._add_holiday_last_mon_of_aug(tr("August Bank Holiday"))
+
+
+class SH(SaintHelenaAscensionAndTristanDaCunha):
+    pass
+
+
+class SHN(SaintHelenaAscensionAndTristanDaCunha):
+    pass
+
+
+class SaintHelenaAscensionAndTristanDaCunhaStaticHolidays:
+    """Saint Helena, Ascension and Tristan da Cunha special holidays.
+
+    References:
+        * <https://web.archive.org/web/20250810194916/https://sainthelenaisland.info/holidays.htm>
+        * [The Duke of Edinburgh's Visit](https://web.archive.org/web/20250719002906/https://www.sainthelena.gov.sh/2024/news/public-holiday-declared-to-mark-visit-of-his-royal-highness-the-duke-of-edinburgh-public-events-announced/)
+        * [Queen Elizabeth II's State Funeral](https://web.archive.org/web/20250513122736/https://www.sainthelena.gov.sh/wp-content/uploads/2022/09/EX-GAZ-94-Proclamation-Proclaiming-His-Majesty-Public-Holiday-HM-Queen-II-Funeral-STH-ASC.pdf)
+        * [Coronation of His Majesty King Charles III](https://web.archive.org/web/20250719085105/https://www.sainthelena.gov.sh/2023/news/governors-deputy-declares-public-holiday-to-mark-the-coronation-of-his-majesty-king-charles-iii/)
+    """
+
+    special_public_holidays = {
+        # Final Departure of R.M.S. St Helena.
+        2018: (FEB, 9, tr("Final Departure of R.M.S. St Helena")),
+        2022: (
+            # Queen Elizabeth II's Platinum Jubilee.
+            (JUN, 3, tr("Queen Elizabeth II's Platinum Jubilee")),
+            # Queen Elizabeth II's State Funeral.
+            (SEP, 19, tr("Queen Elizabeth II's State Funeral")),
+        ),
+        2023: (
+            # The Duke of Edinburgh's Visit.
+            (JAN, 24, tr("The Duke of Edinburgh's Visit")),
+            # Coronation of His Majesty King Charles III.
+            (MAY, 8, tr("Coronation of His Majesty King Charles III")),
+        ),
+    }

holidays/countries/south_korea.py

@@ -81,6 +81,10 @@ class SouthKorea(
     country = "KR"
     supported_categories = (BANK, PUBLIC)
     default_language = "ko"
+    # %s (estimated).
+    estimated_label = tr("%s (추정)")
+    # Alternative holiday for %s (estimated).
+    observed_estimated_label = tr("%s 대체 휴일 (추정)")
     # Alternative holiday for %s.
     observed_label = tr("%s 대체 휴일")
     supported_languages = ("en_US", "ko", "th")

holidays/countries/spain.py

@@ -47,6 +47,25 @@ class Spain(
         * [2024](https://web.archive.org/web/20240401192304/https://www.boe.es/buscar/doc.php?id=BOE-A-2023-22014)
         * [2025](https://web.archive.org/web/20241226214918/https://www.boe.es/buscar/doc.php?id=BOE-A-2024-21316)
 
+    Subdivisions Holidays References:
+        * Navarra:
+            * [2010](https://web.archive.org/web/20250903095706/https://www.lexnavarra.navarra.es/detalle.asp?r=8402)
+            * [2011](https://web.archive.org/web/20250903095217/https://www.lexnavarra.navarra.es/detalle.asp?r=8403)
+            * [2012](https://web.archive.org/web/20250903095133/https://www.lexnavarra.navarra.es/detalle.asp?r=12993)
+            * [2013](https://web.archive.org/web/20250903095136/https://www.lexnavarra.navarra.es/detalle.asp?r=26226)
+            * [2014](https://web.archive.org/web/20250903095123/https://www.lexnavarra.navarra.es/detalle.asp?r=32382)
+            * [2015](https://web.archive.org/web/20250903095257/https://www.lexnavarra.navarra.es/detalle.asp?r=34276)
+            * [2016](https://web.archive.org/web/20250903095302/https://www.lexnavarra.navarra.es/detalle.asp?r=36141)
+            * [2017](https://web.archive.org/web/20250903095306/https://www.lexnavarra.navarra.es/detalle.asp?r=37665)
+            * [2018](https://web.archive.org/web/20170728130845/https://www.lexnavarra.navarra.es/detalle.asp?r=38904)
+            * [2019](https://web.archive.org/web/20250903095819/https://www.lexnavarra.navarra.es/detalle.asp?r=50305)
+            * [2020](https://web.archive.org/web/20250623005808/https://www.lexnavarra.navarra.es/detalle.asp?r=52229)
+            * [2021](https://web.archive.org/web/20250623010750/https://www.lexnavarra.navarra.es/detalle.asp?r=52748)
+            * [2022](https://web.archive.org/web/20250623000851/https://www.lexnavarra.navarra.es/detalle.asp?r=53763)
+            * [2023](https://web.archive.org/web/20250623010106/https://www.lexnavarra.navarra.es/detalle.asp?r=55481)
+            * [2024](https://web.archive.org/web/20250623001355/https://www.lexnavarra.navarra.es/detalle.asp?r=56116)
+            * [2025](https://web.archive.org/web/20250622235218/https://www.lexnavarra.navarra.es/detalle.asp?r=57122)
+
     Holidays checked with official sources for 2010-2025 only.
     """
 
@@ -641,6 +660,9 @@ class Spain(
         if self._year in {2011, 2013, 2015, 2016, 2017} or self._year >= 2022:
             self._add_saint_james_day(tr("Santiago Apóstol"))
 
+        # Saint Francis Xavier's Day.
+        self._move_holiday(self._add_holiday_dec_3(tr("San Francisco Javier")))
+
         if self._year == 2020:
             self._move_holiday(self._add_holiday_dec_6(tr("Día de la Constitución Española")))
 

holidays/countries/sudan.py

@@ -0,0 +1,115 @@
+#  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 _CustomIslamicHolidays
+from holidays.calendars.gregorian import MAY, JUL, AUG, SEP, FRI, SAT
+from holidays.calendars.julian import JULIAN_CALENDAR
+from holidays.groups import ChristianHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Sudan(HolidayBase, ChristianHolidays, IslamicHolidays):
+    """Sudan holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Sudan>
+        * <https://web.archive.org/web/20250820070831/https://www.sudanembassy.org.uk/public-holidays/>
+        * [Christian Holidays 2011-2018](https://web.archive.org/web/20250827155208/https://evangelicalfocus.com/world/5014/christmas-celebrations-mark-progress-of-religious-freedom-in-sudan)
+    """
+
+    country = "SD"
+    default_language = "ar_SD"
+    # %s (estimated).
+    estimated_label = tr("%s (المقدرة)")
+    supported_languages = ("ar_SD", "en_US")
+    start_year = 1985
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        ChristianHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=SudanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # The resting days are Friday and Saturday since January 26th, 2008.
+        # https://sudantribune.com/article25544/
+        self.weekend = {FRI, SAT} if self._year >= 2008 else {FRI}
+
+        # Independence Day.
+        self._add_holiday_jan_1(tr("عيد الإستقلال"))
+
+        # Christian public holidays were suspended 2011–2018 and reinstated in 2019.
+        if self._year <= 2010 or self._year >= 2019:
+            # Coptic Christmas Day.
+            self._add_christmas_day(tr("عيد الميلاد المجيد"), calendar=JULIAN_CALENDAR)
+
+            # Coptic Easter.
+            self._add_easter_sunday(tr("عيد الفصح القبطي"), calendar=JULIAN_CALENDAR)
+
+            # Christmas Day.
+            self._add_christmas_day(tr("عيد الميلاد"))
+
+        # Islamic New Year.
+        self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
+
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("المولد النبوي الشريف"))
+
+        # Eid al-Fitr.
+        name = tr("عيد الفطر المبارك")
+        self._add_eid_al_fitr_day(name)
+        self._add_eid_al_fitr_day_two(name)
+        self._add_eid_al_fitr_day_three(name)
+
+        if self._year >= 2020:
+            self._add_eid_al_fitr_day_four(name)
+
+        # Eid al-Adha.
+        name = tr("عيد الأضحى المبارك")
+        self._add_arafah_day(name)
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
+        self._add_eid_al_adha_day_four(name)
+
+
+class SD(Sudan):
+    pass
+
+
+class SDN(Sudan):
+    pass
+
+
+class SudanIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2020, 2025)
+    EID_AL_ADHA_DATES = {
+        2022: (JUL, 10),
+    }
+
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2020, 2025)
+    EID_AL_FITR_DATES = {
+        2022: (MAY, 1),
+    }
+
+    HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (2020, 2025)
+    HIJRI_NEW_YEAR_DATES = {
+        2021: (AUG, 11),
+    }
+
+    MAWLID_DATES_CONFIRMED_YEARS = (2020, 2025)
+    MAWLID_DATES = {
+        2023: (SEP, 28),
+    }

holidays/countries/taiwan.py

@@ -72,8 +72,12 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
     """
 
     country = "TW"
+    # %s (estimated).
+    estimated_label = tr("%s（推定）")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s（補假，推定）")
     # %s (observed).
-    observed_label = tr("%s（慶祝）")
+    observed_label = tr("%s（補假）")
     default_language = "zh_TW"
     supported_categories = (GOVERNMENT, OPTIONAL, PUBLIC, SCHOOL, WORKDAY)
     supported_languages = ("en_US", "th", "zh_CN", "zh_TW")

holidays/countries/tajikistan.py

@@ -107,7 +107,7 @@ class TJK(Tajikistan):
 
 
 class TajikistanIslamicHolidays(_CustomIslamicHolidays):
-    # https://www.timeanddate.com/holidays/tajikistan/eid-al-fitr
+    # https://web.archive.org/web/20240911001624/https://www.timeanddate.com/holidays/tajikistan/eid-al-fitr
     EID_AL_FITR_DATES_CONFIRMED_YEARS = (1992, 2025)
     EID_AL_FITR_DATES = {
         2023: (APR, 22),

holidays/countries/vietnam.py

@@ -54,6 +54,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/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

holidays/groups/eastern.py

@@ -33,15 +33,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,

holidays/groups/islamic.py

@@ -182,6 +182,16 @@ class IslamicHolidays(EasternCalendarHolidays):
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+2
         )
 
+    def _add_eid_al_fitr_day_four(self, name) -> set[date]:
+        """
+        Add Eid al-Fitr Day Four.
+
+        https://en.wikipedia.org/wiki/Eid_al-Fitr
+        """
+        return self._add_islamic_calendar_holiday(
+            name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+3
+        )
+
     def _add_eid_al_fitr_eve(self, name) -> set[date]:
         """
         Add Eid al-Fitr Eve (last day of 9th month of Islamic calendar).