holidays 0.41__py3-none-any.whl → 0.43__py3-none-any.whl

holidays/countries/taiwan.py

@@ -9,68 +9,86 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
+from datetime import date
 from gettext import gettext as tr
+from typing import Set
 
-from holidays.groups import ChineseCalendarHolidays, InternationalHolidays
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, SEP, OCT, DEC
+from holidays.groups import ChineseCalendarHolidays, InternationalHolidays, StaticHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
+    ObservedRule,
     SAT_TO_PREV_WORKDAY,
     SUN_TO_NEXT_WORKDAY,
+    SAT_SUN_TO_NEXT_WORKDAY,
 )
 
 
-class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays):
+class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays, StaticHolidays):
     """
     References:
-        - https://www.dgpa.gov.tw/information?uid=353&pid=10659
         - https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan
         - https://www.officeholidays.com/countries/taiwan
-
-    If a public holiday falls on Tuesday or Thursday, government establishes an "extended holiday",
-    although this will be compensated by making Saturday a working day.
-    It's not supported yet.
+        - `2024 <https://www.dgpa.gov.tw/en/information?uid=353&pid=11402>`_
+        - `2023 <https://www.dgpa.gov.tw/en/information?uid=353&pid=11016>`_
+        - `2022 <https://www.dgpa.gov.tw/en/information?uid=353&pid=10659>`_
+        - `2021 <https://www.dgpa.gov.tw/en/information?uid=353&pid=10181>`_
+        - `2020 <https://www.dgpa.gov.tw/en/information?uid=353&pid=9724>`_
+        - `2019 <https://www.dgpa.gov.tw/en/information?uid=353&pid=8178>`_
+        - `2018 <https://www.dgpa.gov.tw/en/information?uid=353&pid=7730>`_
+        - `2017 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6178>`_
+        - `2016 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6180>`_
+        - `2015 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6182>`_
+        - `2014 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6183>`_
+        - `2013 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6186>`_
+        - `2012 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6187>`_
+        - `2011 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6188>`_
+        - `2010 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6189>`_
     """
 
     country = "TW"
     # %s (observed).
-    observed_label = tr("%s (慶祝)")
+    observed_label = tr("%s（慶祝）")
     default_language = "zh_TW"
     supported_languages = ("en_US", "th", "zh_CN", "zh_TW")
 
     def __init__(self, *args, **kwargs):
         ChineseCalendarHolidays.__init__(self)
         InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, TaiwanStaticHolidays)
         kwargs.setdefault("observed_rule", SAT_TO_PREV_WORKDAY + SUN_TO_NEXT_WORKDAY)
-        kwargs.setdefault("observed_since", 2015)
         super().__init__(*args, **kwargs)
 
+    def _populate_observed(
+        self, dts: Set[date], rule: ObservedRule = None, since: int = 2015
+    ) -> None:
+        if self._year < since:
+            return None
+        for dt in sorted(dts):
+            for name in self.get_list(dt):
+                self._add_observed(dt, name, rule)
+
     def _populate_public_holidays(self):
         if self._year <= 1911:
             return None
 
         dts_observed = set()
+        dts_observed_forward = set()
 
         # Founding Day of the Republic of China.
         name = tr("中華民國開國紀念日")
         dts_observed.add(self._add_new_years_day(name))
-        self._add_observed(self._next_year_new_years_day, name=name)
+        if self._year >= 2015:
+            self._add_observed(self._next_year_new_years_day, name=name)
 
         # Chinese New Year's Eve.
-        self._add_chinese_new_years_eve(tr("農曆除夕"))
+        dts_observed_forward.add(self._add_chinese_new_years_eve(tr("農曆除夕")))
 
         # Chinese New Year.
         name = tr("春節")
-        dt = self._add_chinese_new_years_day(name)
-        self._add_chinese_new_years_day_two(name)
-        self._add_chinese_new_years_day_three(name)
-        if self.observed and self._year >= 2015:
-            if self._is_monday(dt):
-                self._add_chinese_new_years_day_four(name)
-            elif self._is_thursday(dt):
-                self._add_chinese_new_years_day_five(name)
-            elif self._is_friday(dt) or self._is_weekend(dt):
-                self._add_chinese_new_years_day_four(name)
-                self._add_chinese_new_years_day_five(name)
+        dts_observed_forward.add(self._add_chinese_new_years_day(name))
+        dts_observed_forward.add(self._add_chinese_new_years_day_two(name))
+        dts_observed_forward.add(self._add_chinese_new_years_day_three(name))
 
         if self._year >= 1997:
             # Peace Memorial Day.
@@ -78,7 +96,9 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
 
         if 1990 <= self._year <= 1999 or self._year >= 2011:
             # Children's Day.
-            dts_observed.add(self._add_holiday_apr_4(tr("兒童節")))
+            apr_4 = self._add_holiday_apr_4(tr("兒童節"))
+            if self._year != 2021:
+                dts_observed.add(apr_4)
 
         if self._year >= 1972:
             # Tomb Sweeping Day.
@@ -94,7 +114,8 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
         dts_observed.add(self._add_holiday_oct_10(tr("中華民國國慶日")))
 
         if self.observed:
-            self._populate_observed(dts_observed, multiple=True)
+            self._populate_observed(dts_observed)
+            self._populate_observed(dts_observed_forward, rule=SAT_SUN_TO_NEXT_WORKDAY, since=2010)
 
 
 class TW(Taiwan):
@@ -103,3 +124,72 @@ class TW(Taiwan):
 
 class TWN(Taiwan):
     pass
+
+
+class TaiwanStaticHolidays:
+    # Date format (see strftime() Format Codes).
+    substituted_date_format = tr("%Y-%m-%d")
+    # Day off (substituted from %s).
+    substituted_label = tr("休息日（%s日起取代）")
+
+    childrens_day = tr("兒童節")
+
+    special_public_holidays = {
+        2010: (FEB, 19, FEB, 6),
+        2012: (
+            (JAN, 27, FEB, 4),
+            (FEB, 27, MAR, 3),
+            (DEC, 31, DEC, 22),
+        ),
+        2013: (
+            (FEB, 15, FEB, 23),
+            (SEP, 20, SEP, 14),
+        ),
+        2015: (JAN, 2, DEC, 27, 2014),
+        2016: (
+            (FEB, 12, JAN, 30),
+            (JUN, 10, JUN, 4),
+            (SEP, 16, SEP, 10),
+        ),
+        2017: (
+            (FEB, 27, FEB, 18),
+            (MAY, 29, JUN, 3),
+            (OCT, 9, SEP, 30),
+        ),
+        2018: (
+            (APR, 6, MAR, 31),
+            (DEC, 31, DEC, 22),
+        ),
+        2019: (
+            (FEB, 8, JAN, 19),
+            (MAR, 1, FEB, 23),
+            (OCT, 11, OCT, 5),
+        ),
+        2020: (
+            (JAN, 23, FEB, 15),
+            (JUN, 26, JUN, 20),
+            (OCT, 2, SEP, 26),
+        ),
+        2021: (
+            (FEB, 10, FEB, 20),
+            (SEP, 20, SEP, 11),
+        ),
+        2022: (FEB, 4, JAN, 22),
+        2023: (
+            (JAN, 20, JAN, 7),
+            (JAN, 27, FEB, 4),
+            (FEB, 27, FEB, 18),
+            (APR, 3, MAR, 25),
+            (JUN, 23, JUN, 17),
+            (OCT, 9, SEP, 23),
+        ),
+        2024: (FEB, 8, FEB, 17),
+    }
+
+    special_public_holidays_observed = {
+        2013: (APR, 5, childrens_day),
+        2016: (APR, 5, childrens_day),
+        2017: (APR, 3, childrens_day),
+        2021: (APR, 2, childrens_day),
+        2024: (APR, 5, childrens_day),
+    }

holidays/countries/tanzania.py

@@ -60,6 +60,7 @@ class Tanzania(
     country = "TZ"
     supported_categories = (BANK, PUBLIC)
     default_language = "sw"
+    # %s (estimated).
     estimated_label = tr("%s (makisio)")
     supported_languages = ("en_US", "sw")
 

holidays/countries/thailand.py

@@ -237,7 +237,7 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
         # *** NOTE: only observed by financial and private sectors.
 
         if self._year >= 1974:
-            # National Labour day.
+            # National Labor Day.
             self._add_observed(self._add_labor_day(tr("วันแรงงานแห่งชาติ")))
 
         # วันชาติ
@@ -338,8 +338,7 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
             elif self._year >= 2019:
                 # Anniversary for the Death of King Bhumibol Adulyadej the Great.
                 k_bhumibol_memorial = tr(
-                    "วันคล้ายวันสวรรคตพระบาทสมเด็จพระบรมชนกาธิเบศร "
-                    "มหาภูมิพลอดุลยเดชมหาราช บรมนาถบพิตร"
+                    "วันคล้ายวันสวรรคตพระบาทสมเด็จพระบรมชนกาธิเบศร มหาภูมิพลอดุลยเดชมหาราช บรมนาถบพิตร"
                 )
             else:
                 # Anniversary for the Death of King Bhumibol Adulyadej.
@@ -375,10 +374,7 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
             elif self._year >= 2016:
                 k_bhumibol_bday = (
                     # HM King Bhumibol Adulyadej Birthday Anniversary.
-                    tr(
-                        "วันคล้ายวันเฉลิมพระชนมพรรษา"
-                        "พระบาทสมเด็จพระปรมินทรมหาภูมิพลอดุลยเดช บรมนาถบพิตร"
-                    )
+                    tr("วันคล้ายวันเฉลิมพระชนมพรรษาพระบาทสมเด็จพระปรมินทรมหาภูมิพลอดุลยเดช บรมนาถบพิตร")
                 )
             else:
                 k_bhumibol_bday = (
@@ -504,10 +500,7 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
         if self._year <= 2021:
             self._add_holiday_apr_1(
                 # Additional Closing Day for Bank for Agriculture and Agricultural Cooperatives
-                tr(
-                    "วันหยุดเพิ่มเติมสำหรับการปิดบัญชีประจำปีของ"
-                    "ธนาคารเพื่อการเกษตรและสหกรณ์การเกษตร"
-                ),
+                tr("วันหยุดเพิ่มเติมสำหรับการปิดบัญชีประจำปีของธนาคารเพื่อการเกษตรและสหกรณ์การเกษตร"),
             )
 
         # วันหยุดภาคครึ่งปีของสถาบันการเงินและสถาบันการเงินเฉพาะกิจ
@@ -728,13 +721,9 @@ class ThailandStaticHolidays:
     # Day of Mourning for HM King Bhumibol Adulyadej.
     rama_ix_mourning = tr("วันหยุดพิเศษ (ร่วมถวายอาลัย ส่งดวงพระวิญญาณพระบรมศพ)")
     # HM King Bhumibol Adulyadej's Royal Cremation Ceremony.
-    rama_ix_cremation = tr(
-        "วันพระราชพิธีถวายพระเพลิงพระบรมศพพระบาทสมเด็จพระปรมินทรมหาภูมิพลอดุลยเดช"
-    )
+    rama_ix_cremation = tr("วันพระราชพิธีถวายพระเพลิงพระบรมศพพระบาทสมเด็จพระปรมินทรมหาภูมิพลอดุลยเดช")
     # HM King Maha Vajiralongkorn's Coronation Celebrations.
-    rama_x_coronation_celebrations = tr(
-        "พระราชพิธีบรมราชาภิเษก พระบาทสมเด็จพระวชิรเกล้าเจ้าอยู่หัว"
-    )
+    rama_x_coronation_celebrations = tr("พระราชพิธีบรมราชาภิเษก พระบาทสมเด็จพระวชิรเกล้าเจ้าอยู่หัว")
     # Songkran Festival.
     songkran_festival = tr("วันสงกรานต์")
 
@@ -840,7 +829,10 @@ class ThailandStaticHolidays:
             (JUL, 31, thai_bridge_public_holiday),
             (DEC, 29, thai_bridge_public_holiday),
         ),
-        2024: (DEC, 30, thai_bridge_public_holiday),
+        2024: (
+            (APR, 12, thai_bridge_public_holiday),
+            (DEC, 30, thai_bridge_public_holiday),
+        ),
     }
     special_workday_holidays = {1999: (MAY, 14, tr("วันพืชมงคล"))}
 

holidays/countries/timor_leste.py

@@ -43,6 +43,7 @@ class TimorLeste(
     country = "TL"
     supported_categories = (GOVERNMENT, PUBLIC, WORKDAY)
     default_language = "pt_TL"
+    # %s (estimated).
     estimated_label = tr("%s (aproximada)")
     supported_languages = ("en_US", "pt_TL", "tet")
 

holidays/countries/tunisia.py

@@ -21,7 +21,7 @@ class Tunisia(HolidayBase, InternationalHolidays, IslamicHolidays):
 
     country = "TN"
     default_language = "ar"
-    # Estimated label.
+    # %s (estimated).
     estimated_label = tr("(تقدير) %s")
     supported_languages = ("ar", "en_US")
 
@@ -68,14 +68,14 @@ class Tunisia(HolidayBase, InternationalHolidays, IslamicHolidays):
         # Eid al-Adha.
         name = tr("عيد الأضحى")
         self._add_eid_al_adha_day(name)
-        # Eid al-Adha Holiday
+        # Eid al-Adha Holiday.
         self._add_eid_al_adha_day_two(tr("عطلة عيد الأضحى"))
         self._add_eid_al_adha_day_three(tr("عطلة عيد الأضحى"))
 
         # Islamic New Year.
         self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
 
-        # Prophet Muhammad's Birthday.
+        # Prophet's Birthday.
         self._add_mawlid_day(tr("عيد المولد النبوي"))
 
 

holidays/countries/turkey.py

@@ -30,7 +30,7 @@ class Turkey(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays
 
     country = "TR"
     default_language = "tr"
-    # Estimated label.
+    # %s (estimated).
     estimated_label = tr("%s (tahmini)")
     supported_categories = (HALF_DAY, PUBLIC)
     supported_languages = ("en_US", "tr", "uk")
@@ -105,6 +105,7 @@ class Turkey(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays
         if self._year <= 1935:
             return None
 
+        # %s (from 1pm).
         begin_time_label = self.tr("%s (saat 13.00'ten)")
 
         # Republic Day.

holidays/countries/ukraine.py

@@ -79,7 +79,7 @@ class Ukraine(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
         dts_observed.add(self._add_new_years_day(tr("Новий рік")))
 
         dts_observed.add(
-            # Christmas (Julian calendar).
+            # Christmas Day (Julian calendar).
             self._add_christmas_day(tr("Різдво Христове (за юліанським календарем)"))
         )
 
@@ -97,7 +97,7 @@ class Ukraine(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
             dts_observed.add(self._add_whit_sunday(tr("Трійця")))
 
             name = (
-                # Labour Day.
+                # Labor Day.
                 tr("День праці")
                 if self._year >= 2018
                 # International Workers' Solidarity Day.
@@ -146,7 +146,7 @@ class Ukraine(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
             if self._year >= 2017:
                 dts_observed.add(
                     self._add_christmas_day(
-                        # Christmas (Gregorian calendar).
+                        # Christmas Day (Gregorian calendar).
                         tr("Різдво Христове (за григоріанським календарем)"),
                         GREGORIAN_CALENDAR,
                     )

holidays/countries/united_arab_emirates.py

@@ -12,37 +12,26 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import APR, MAY, JUN, JUL, AUG, SEP, NOV, FRI, SAT
+from holidays.calendars.gregorian import APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, FRI, SAT
 from holidays.groups import InternationalHolidays, IslamicHolidays
 from holidays.holiday_base import HolidayBase
 
 
 class UnitedArabEmirates(HolidayBase, InternationalHolidays, IslamicHolidays):
     """
-    Holidays are regulated by the Article 74
-    of Federal Law No. 08 for the year 1980:
+    Holidays are regulated by the Article 74 of Federal Law No. 08 for the year 1980:
     https://www.ilo.org/dyn/natlex/docs/ELECTRONIC/11956/69376/F417089305/ARE11956.pdf
-    However the law is not applied literally,
-    and was amended often in the past few years.
+    However the law is not applied literally, and was amended often in the past few years.
     Sources:
     2017: https://www.khaleejtimes.com/nation/uae-official-public-holidays-list-2017
     2018: https://www.thenational.ae/uae/government/uae-public-holidays-2018-announced-by-abu-dhabi-government-1.691393  # noqa: E501
     2019: https://www.thenational.ae/uae/government/uae-public-holidays-for-2019-and-2020-announced-by-cabinet-1.833425  # noqa: E501
     2020: https://u.ae/en/information-and-services/public-holidays-and-religious-affairs/public-holidays  # noqa: E501
-
-    Holidays based on the Islamic Calendar are estimated (and so denoted),
-    as are announced each year and based on moon sightings:
-    - Eid al-Fitr
-    - Eid al-Adha
-    - Arafat (Hajj) Day
-    - Al-Hijra (Islamic New Year
-    - Mawlud al-Nabi (Prophet Mohammad's Birthday)
-    - Leilat al-Miraj (Ascension of the Prophet), suspended after 2018.
     """
 
     country = "AE"
     default_language = "ar"
-    # Estimated label.
+    # %s (estimated).
     estimated_label = tr("(تقدير) %s")
     supported_languages = ("ar", "en_US")
     weekend = {FRI, SAT}
@@ -56,7 +45,7 @@ class UnitedArabEmirates(HolidayBase, InternationalHolidays, IslamicHolidays):
         # New Year's Day.
         self._add_new_years_day(tr("رأس السنة الميلادية"))
 
-        if self._year >= 2015:
+        if 2015 <= self._year <= 2022:
             # Commemoration Day.
             name = tr("يوم الشهيد")
             if self._year >= 2019:
@@ -65,34 +54,40 @@ class UnitedArabEmirates(HolidayBase, InternationalHolidays, IslamicHolidays):
                 self._add_holiday_nov_30(name)
 
         # National Day.
-        self._add_holiday_dec_2(tr("اليوم الوطني"))
-        self._add_holiday_dec_3(tr("اليوم الوطني"))
+        national_day = tr("اليوم الوطني")
+        self._add_holiday_dec_2(national_day)
+        self._add_holiday_dec_3(national_day)
 
         # Eid al-Fitr.
         self._add_eid_al_fitr_day(tr("عيد الفطر"))
+
         # Eid al-Fitr Holiday.
-        self._add_eid_al_fitr_day_two(tr("عطلة عيد الفطر"))
-        self._add_eid_al_fitr_day_three(tr("عطلة عيد الفطر"))
+        eid_al_fitr_holiday = tr("عطلة عيد الفطر")
+        self._add_eid_al_fitr_day_two(eid_al_fitr_holiday)
+        self._add_eid_al_fitr_day_three(eid_al_fitr_holiday)
+        if self._year >= 2019:
+            self._add_eid_al_fitr_eve(eid_al_fitr_holiday)
 
         # Arafat Day.
         self._add_arafah_day(tr("وقفة عرفة"))
 
         # Eid al-Adha.
         self._add_eid_al_adha_day(tr("عيد الأضحى"))
+
         # Eid al-Adha Holiday.
-        self._add_eid_al_adha_day_two(tr("عطلة عيد الأضحى"))
-        self._add_eid_al_adha_day_three(tr("عطلة عيد الأضحى"))
+        eid_al_adha_holiday = tr("عطلة عيد الأضحى")
+        self._add_eid_al_adha_day_two(eid_al_adha_holiday)
+        self._add_eid_al_adha_day_three(eid_al_adha_holiday)
 
         # Islamic New Year.
         self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
 
-        # Leilat al-Miraj.
-        if self._year <= 2018:  # The UAE government removed this starting 2019.
+        if self._year <= 2018:
+            # Isra' and Mi'raj.
             self._add_isra_and_miraj_day(tr("ليلة المعراج"))
 
-        # Prophet Muhammad's Birthday.
-        if self._year <= 2019:  # The UAE government removed this starting 2020.
-            self._add_mawlid_day(tr("عيد المولد النبوي"))
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("عيد المولد النبوي"))
 
 
 class AE(UnitedArabEmirates):
@@ -109,13 +104,19 @@ class UnitedArabEmiratesIslamicHolidays(_CustomIslamicHolidays):
         2018: (AUG, 21),
         2019: (AUG, 11),
         2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
     }
 
     EID_AL_FITR_DATES = {
         2017: (JUN, 25),
         2018: (JUN, 14),
-        2019: (JUN, 3),
+        2019: (JUN, 4),
         2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 21),
     }
 
     HIJRI_NEW_YEAR_DATES = {
@@ -123,6 +124,9 @@ class UnitedArabEmiratesIslamicHolidays(_CustomIslamicHolidays):
         2018: (SEP, 11),
         2019: (AUG, 31),
         2020: (AUG, 23),
+        2021: (AUG, 12),
+        2022: (JUL, 30),
+        2023: (JUL, 21),
     }
 
     ISRA_AND_MIRAJ_DATES = {
@@ -134,4 +138,8 @@ class UnitedArabEmiratesIslamicHolidays(_CustomIslamicHolidays):
         2017: (NOV, 30),
         2018: (NOV, 19),
         2019: (NOV, 9),
+        2020: (OCT, 29),
+        2021: (OCT, 21),
+        2022: (OCT, 8),
+        2023: (SEP, 29),
     }

holidays/countries/united_kingdom.py

@@ -25,8 +25,14 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
     """
     References:
     - https://en.wikipedia.org/wiki/Public_holidays_in_the_United_Kingdom
+    - https://archive.org/details/treatiseonbanki00walk/page/334/mode/2up
     - https://www.gov.uk/bank-holidays
     - https://www.timeanddate.com/holidays/uk/
+
+    The Anniversary of the Battle of the Boyne bank holiday is proclaimed annually by the
+    Secretary of State for Northern Ireland.
+
+    In-Lieu observance was first provided in the Bank Holidays Extension Act 1875.
     """
 
     country = "GB"
@@ -51,9 +57,15 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
         InternationalHolidays.__init__(self)
         StaticHolidays.__init__(self, UnitedKingdomStaticHolidays)
         kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
+        # Bank Holidays Extension Act 1875
+        kwargs.setdefault("observed_since", 1875)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self) -> None:
+        # Bank Holidays Act 1871
+        if self._year <= 1871:
+            return None
+
         # Good Friday
         self._add_good_friday("Good Friday")
 
@@ -88,6 +100,10 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
             self._populate_subdiv_wls_public_holidays()
 
     def _populate_subdiv_holidays(self):
+        # Bank Holidays Act 1871
+        if self._year <= 1871:
+            return None
+
         if self.subdiv not in {"SCT", "Scotland"}:
             # New Year's Day
             if self._year >= 1975:
@@ -109,6 +125,10 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
         # Easter Monday
         self._add_easter_monday("Easter Monday")
 
+        # Whit Monday.
+        if self._year <= 1970:
+            self._add_whit_monday("Whit Monday")
+
         # Late Summer bank holiday (last Monday in August)
         if self._year >= 1971:
             self._add_holiday_last_mon_of_aug("Late Summer Bank Holiday")
@@ -121,6 +141,10 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
         # Easter Monday
         self._add_easter_monday("Easter Monday")
 
+        # Whit Monday.
+        if self._year <= 1970:
+            self._add_whit_monday("Whit Monday")
+
         # Battle of the Boyne
         self._add_observed(self._add_holiday_jul_12("Battle of the Boyne"))
 
@@ -161,6 +185,10 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
         # Easter Monday
         self._add_easter_monday("Easter Monday")
 
+        # Whit Monday.
+        if self._year <= 1970:
+            self._add_whit_monday("Whit Monday")
+
         # Late Summer bank holiday (last Monday in August)
         if self._year >= 1971:
             self._add_holiday_last_mon_of_aug("Late Summer Bank Holiday")

holidays/holiday_base.py

@@ -209,6 +209,9 @@ class HolidayBase(Dict[date, str]):
     """The market's ISO 3166-1 alpha-2 code."""
     subdivisions: Tuple[str, ...] = ()
     """The subdivisions supported for this country (see documentation)."""
+    subdivisions_aliases: Dict[str, str] = {}
+    """Aliases for the ISO 3166-2 subdivision codes with the key as alias and
+    the value the ISO 3166-2 subdivision code."""
     years: Set[int]
     """The years calculated."""
     expand: bool
@@ -217,7 +220,7 @@ class HolidayBase(Dict[date, str]):
     observed: bool
     """Whether dates when public holiday are observed are included."""
     subdiv: Optional[str] = None
-    """The subdiv requested."""
+    """The subdiv requested as ISO 3166-2 code or one of the aliases."""
     special_holidays: Dict[int, Union[SpecialHoliday, SubstitutedHoliday]] = {}
     """A list of the country-wide special (as opposite to regular) holidays for
     a specific year."""
@@ -262,8 +265,8 @@ class HolidayBase(Dict[date, str]):
             following Monday). This doesn't work for all countries.
 
         :param subdiv:
-            The subdivision (e.g. state or province); not implemented for all
-            countries (see documentation).
+            The subdivision (e.g. state or province) as a ISO 3166-2 code
+            or its alias; not implemented for all countries (see documentation).
 
         :param prov:
             *deprecated* use subdiv instead.
@@ -304,10 +307,10 @@ class HolidayBase(Dict[date, str]):
             if isinstance(subdiv, int):
                 subdiv = str(subdiv)
 
+            subdivisions_aliases = tuple(sorted(self.subdivisions_aliases))
             # Unsupported subdivisions.
-            if (
-                not isinstance(self, HolidaySum)
-                and subdiv not in self.subdivisions + self._deprecated_subdivisions
+            if not isinstance(self, HolidaySum) and subdiv not in (
+                self.subdivisions + subdivisions_aliases + self._deprecated_subdivisions
             ):
                 raise NotImplementedError(
                     f"Entity `{self._entity_code}` does not have subdivision {subdiv}"
@@ -326,7 +329,9 @@ class HolidayBase(Dict[date, str]):
                 warnings.warn(
                     "This subdivision is deprecated and will be removed after "
                     "Dec, 1 2023. The list of supported subdivisions: "
-                    f"{', '.join(sorted(self.subdivisions))}.",
+                    f"{', '.join(sorted(self.subdivisions))}; "
+                    "the list of supported subdivisions aliases: "
+                    f"{', '.join(subdivisions_aliases)}.",
                     DeprecationWarning,
                 )
 
@@ -657,19 +662,32 @@ class HolidayBase(Dict[date, str]):
 
     @cached_property
     def _normalized_subdiv(self):
-        return self.subdiv.translate(
-            str.maketrans(
-                {
-                    "-": "_",
-                    " ": "_",
-                }
+        return (
+            self.subdivisions_aliases.get(self.subdiv, self.subdiv)
+            .translate(
+                str.maketrans(
+                    {
+                        "-": "_",
+                        " ": "_",
+                    }
+                )
             )
-        ).lower()
+            .lower()
+        )
 
     @cached_property
     def _sorted_categories(self):
         return sorted(self.categories)
 
+    @classmethod
+    def get_subdivision_aliases(cls) -> Dict[str, List]:
+        """Get subdivision aliases."""
+        subdivision_aliases: Dict[str, List[str]] = {s: [] for s in cls.subdivisions}
+        for alias, subdivision in cls.subdivisions_aliases.items():
+            subdivision_aliases[subdivision].append(alias)
+
+        return subdivision_aliases
+
     def _is_leap_year(self) -> bool:
         """
         Returns True if the year is leap. Returns False otherwise.