holidays 0.42__tar.gz → 0.43__tar.gz

{holidays-0.42 → holidays-0.43}/CHANGES

@@ -1,3 +1,14 @@
+Version 0.43
+============
+
+Released February 19, 2024
+
+- Introduce subdivisions aliases (#1662 by @sphh, @arkid15r)
+- Update Ireland holidays (#1687 by @KJhellico)
+- Update Portugal holidays: fix Carnival date (#1694 by @DgRosa)
+- Update Taiwan holidays (#1688 by @KJhellico)
+- Update Thailand holidays: add Bridge Public Holiday on Apr 12, 2024 (#1690 by @PPsyrius)
+
 Version 0.42
 ============
 

{holidays-0.42 → holidays-0.43}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: holidays
-Version: 0.42
+Version: 0.43
 Summary: Generate and work with holidays in Python
 Author-email: Maurizio Montel <dr.prodigy.github@gmail.com>
 Maintainer-email: Arkadii Yakovets <ark@cho.red>, Serhii Murza <jhellico@gmail.com>
@@ -193,8 +193,10 @@ Available Countries
 
 We currently support 143 country codes. The standard way to refer to a country
 is by using its `ISO 3166-1 alpha-2 code`_, the same used for domain names, and
-for a subdivision its `ISO 3166-2 code`_. Some of the countries support more
-than one language for holiday names output.
+for a subdivision its `ISO 3166-2 code`_. Some countries have common or foreign
+names or abbreviations as aliases for their subdivisions. These are defined in
+the (optional) ``subdivisions_aliases`` attribute.
+Some of the countries support more than one language for holiday names output.
 A default language is defined by ``default_language`` (optional) attribute
 for each entity and is used as a fallback when neither user specified
 language nor user locale language available. The default language code is
@@ -207,8 +209,9 @@ bank holidays, school holidays, additional (paid or non-paid) holidays, holidays
 public employees, religious holidays (valid only for these religions followers). A list of all
 categories supported by country is defined by ``supported_categories`` (optional) attribute.
 
-The following is a list of supported countries, their subdivisions, available languages and
-additional categories. All countries support **PUBLIC** holidays category by default.
+The following is a list of supported countries, their subdivisions followed by their
+aliases (if any) in brackets, available languages and additional holiday categories.
+All countries support **PUBLIC** holidays category by default.
 All other default values are highlighted with bold:
 
 
@@ -269,7 +272,7 @@ All other default values are highlighted with bold:
      -
    * - Austria
      - AT
-     - States: 1, 2, 3, 4, 5, 6, 7, 8, **9**
+     - States: 1 (Burgenland, Bgld, B), 2 (Kärnten, Ktn, K), 3 (Niederösterreich, NÖ, N), 4 (Oberösterreich, OÖ, O), 5 (Salzburg, Sbg, S), 6 (Steiermark, Stmk, St), 7 (Tirol, T), 8 (Vorarlberg, Vbg, V), 9 (Wien, W)
      - **de**, en_US, uk
      - BANK
    * - Azerbaijan

{holidays-0.42 → holidays-0.43}/README.rst

@@ -144,8 +144,10 @@ Available Countries
 
 We currently support 143 country codes. The standard way to refer to a country
 is by using its `ISO 3166-1 alpha-2 code`_, the same used for domain names, and
-for a subdivision its `ISO 3166-2 code`_. Some of the countries support more
-than one language for holiday names output.
+for a subdivision its `ISO 3166-2 code`_. Some countries have common or foreign
+names or abbreviations as aliases for their subdivisions. These are defined in
+the (optional) ``subdivisions_aliases`` attribute.
+Some of the countries support more than one language for holiday names output.
 A default language is defined by ``default_language`` (optional) attribute
 for each entity and is used as a fallback when neither user specified
 language nor user locale language available. The default language code is
@@ -158,8 +160,9 @@ bank holidays, school holidays, additional (paid or non-paid) holidays, holidays
 public employees, religious holidays (valid only for these religions followers). A list of all
 categories supported by country is defined by ``supported_categories`` (optional) attribute.
 
-The following is a list of supported countries, their subdivisions, available languages and
-additional categories. All countries support **PUBLIC** holidays category by default.
+The following is a list of supported countries, their subdivisions followed by their
+aliases (if any) in brackets, available languages and additional holiday categories.
+All countries support **PUBLIC** holidays category by default.
 All other default values are highlighted with bold:
 
 
@@ -220,7 +223,7 @@ All other default values are highlighted with bold:
      -
    * - Austria
      - AT
-     - States: 1, 2, 3, 4, 5, 6, 7, 8, **9**
+     - States: 1 (Burgenland, Bgld, B), 2 (Kärnten, Ktn, K), 3 (Niederösterreich, NÖ, N), 4 (Oberösterreich, OÖ, O), 5 (Salzburg, Sbg, S), 6 (Steiermark, Stmk, St), 7 (Tirol, T), 8 (Vorarlberg, Vbg, V), 9 (Wien, W)
      - **de**, en_US, uk
      - BANK
    * - Azerbaijan

{holidays-0.42 → holidays-0.43}/holidays/__init__.py

@@ -16,7 +16,7 @@ from holidays.holiday_base import *
 from holidays.registry import EntityLoader
 from holidays.utils import *
 
-__version__ = "0.42"
+__version__ = "0.43"
 
 
 EntityLoader.load("countries", globals())

{holidays-0.42 → holidays-0.43}/holidays/countries/austria.py

@@ -21,16 +21,48 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
     default_language = "de"
     supported_categories = (BANK, PUBLIC)
     supported_languages = ("de", "en_US", "uk")
-    subdivisions = ("1", "2", "3", "4", "5", "6", "7", "8", "9")
+    subdivisions = (
+        "1",  # Burgenland.
+        "2",  # Kärnten.
+        "3",  # Niederösterreich.
+        "4",  # Oberösterreich.
+        "5",  # Salzburg.
+        "6",  # Steiermark.
+        "7",  # Tirol.
+        "8",  # Vorarlberg.
+        "9",  # Wien.
+    )
+    subdivisions_aliases = {
+        "Burgenland": "1",
+        "Bgld": "1",
+        "B": "1",
+        "Kärnten": "2",
+        "Ktn": "2",
+        "K": "2",
+        "Niederösterreich": "3",
+        "NÖ": "3",
+        "N": "3",
+        "Oberösterreich": "4",
+        "OÖ": "4",
+        "O": "4",
+        "Salzburg": "5",
+        "Sbg": "5",
+        "S": "5",
+        "Steiermark": "6",
+        "Stmk": "6",
+        "St": "6",
+        "Tirol": "7",
+        "T": "7",
+        "Vorarlberg": "8",
+        "Vbg": "8",
+        "V": "8",
+        "Wien": "9",
+        "W": "9",
+    }
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-
-        # Set the default subdivision.
-        if not kwargs.get("subdiv", kwargs.get("state")):
-            kwargs["subdiv"] = "9"
-
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
@@ -58,11 +90,12 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Assumption Day.
         self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
+        # National Day.
+        national_day = tr("Nationalfeiertag")
         if 1919 <= self._year <= 1934:
-            # National Day.
-            self._add_holiday_nov_12(tr("Nationalfeiertag"))
+            self._add_holiday_nov_12(national_day)
         if self._year >= 1967:
-            self._add_holiday_oct_26(tr("Nationalfeiertag"))
+            self._add_holiday_oct_26(national_day)
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
@@ -86,6 +119,46 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # New Year's Eve.
         self._add_new_years_eve(tr("Silvester"))
 
+    def _populate_subdiv_1_bank_holidays(self):
+        # St. Martin's Day.
+        self._add_holiday_nov_11(tr("Hl. Martin"))
+
+    def _populate_subdiv_2_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+        # 1920 Carinthian plebiscite.
+        self._add_holiday_oct_10(tr("Tag der Volksabstimmung"))
+
+    def _populate_subdiv_3_bank_holidays(self):
+        # St. Leopold's Day.
+        self._add_holiday_nov_15(tr("Hl. Leopold"))
+
+    def _populate_subdiv_4_bank_holidays(self):
+        if self._year >= 2004:
+            # St. Florian's Day.
+            self._add_holiday_may_4(tr("Hl. Florian"))
+
+    def _populate_subdiv_5_bank_holidays(self):
+        # St. Rupert's Day.
+        self._add_holiday_sep_24(tr("Hl. Rupert"))
+
+    def _populate_subdiv_6_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_7_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_8_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_9_bank_holidays(self):
+        # St. Leopold's Day.
+        self._add_holiday_nov_15(tr("Hl. Leopold"))
+
 
 class AT(Austria):
     pass

{holidays-0.42 → holidays-0.43}/holidays/countries/ireland.py

@@ -9,35 +9,33 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.calendars.gregorian import FEB, MAR
+from holidays.calendars.gregorian import FEB, MAR, SEP, DEC
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
-from holidays.observed_holiday_base import (
-    ObservedHolidayBase,
-    SAT_SUN_TO_NEXT_MON,
-    SAT_SUN_TO_NEXT_MON_TUE,
-)
+from holidays.holiday_base import HolidayBase
 
 
-class Ireland(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+class Ireland(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
     """
-    Official holidays in Ireland, as declared in the Citizen's Information
-    bulletin:
-    https://www.citizensinformation.ie/en/employment/employment_rights_and_conditions/leave_and_holidays/public_holidays_in_ireland.html
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_the_Republic_of_Ireland
+        - https://www.citizensinformation.ie/en/employment/employment_rights_and_conditions/leave_and_holidays/public_holidays_in_ireland.html  # noqa: E501
     """
 
     country = "IE"
-    observed_label = "%s (observed)"
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
         StaticHolidays.__init__(self, IrelandStaticHolidays)
-        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        if self._year <= 1871:
+            return None
+
         # New Year's Day.
-        self._add_new_years_day("New Year's Day")
+        if self._year >= 1975:
+            self._add_new_years_day("New Year's Day")
 
         # St. Brigid's Day.
         if self._year >= 2023:
@@ -48,35 +46,39 @@ class Ireland(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
                 self._add_holiday_1st_mon_from_feb_1(name)
 
         # St. Patrick's Day.
-        self._add_observed(self._add_holiday_mar_17("St. Patrick's Day"))
+        if self._year >= 1903:
+            self._add_holiday_mar_17("St. Patrick's Day")
 
         # Easter Monday.
         self._add_easter_monday("Easter Monday")
 
         # May Day.
-        if self._year >= 1978:
+        if self._year >= 1994:
             name = "May Day"
             if self._year == 1995:
                 self._add_holiday_may_8(name)
             else:
                 self._add_holiday_1st_mon_of_may(name)
 
-        # June Bank holiday.
-        self._add_holiday_1st_mon_of_jun("June Bank Holiday")
+        if self._year >= 1973:
+            # June Bank Holiday.
+            self._add_holiday_1st_mon_of_jun("June Bank Holiday")
+        else:
+            # Whit Monday.
+            self._add_whit_monday("Whit Monday")
 
-        # Summer Bank holiday.
+        # August Bank Holiday.
         self._add_holiday_1st_mon_of_aug("August Bank Holiday")
 
         # October Bank Holiday.
-        self._add_holiday_last_mon_of_oct("October Bank Holiday")
+        if self._year >= 1977:
+            self._add_holiday_last_mon_of_oct("October Bank Holiday")
 
         # Christmas Day.
-        self._add_observed(self._add_christmas_day("Christmas Day"))
+        self._add_christmas_day("Christmas Day")
 
         # St. Stephen's Day.
-        self._add_observed(
-            self._add_christmas_day_two("St. Stephen's Day"), rule=SAT_SUN_TO_NEXT_MON_TUE
-        )
+        self._add_christmas_day_two("St. Stephen's Day")
 
 
 class IE(Ireland):
@@ -89,5 +91,7 @@ class IRL(Ireland):
 
 class IrelandStaticHolidays:
     special_public_holidays = {
+        1999: (DEC, 31, "Millennium Celebrations"),
+        2011: (SEP, 14, "National Day of Mourning"),
         2022: (MAR, 18, "Day of Remembrance and Recognition"),
     }

{holidays-0.42 → holidays-0.43}/holidays/countries/portugal.py

@@ -145,7 +145,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         # - get Holidays that occur on Thursday and add Friday (+1 day)
 
         # Carnival.
-        self._add_carnival_monday(tr("Carnaval"))
+        self._add_carnival_tuesday(tr("Carnaval"))
 
         # St. Anthony's Day.
         self._add_holiday_jun_13(tr("Dia de Santo António"))

holidays-0.43/holidays/countries/taiwan.py

@@ -0,0 +1,195 @@
+#  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 datetime import date
+from gettext import gettext as tr
+from typing import Set
+
+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, StaticHolidays):
+    """
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan
+        - https://www.officeholidays.com/countries/taiwan
+        - `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（慶祝）")
+    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)
+        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))
+        if self._year >= 2015:
+            self._add_observed(self._next_year_new_years_day, name=name)
+
+        # Chinese New Year's Eve.
+        dts_observed_forward.add(self._add_chinese_new_years_eve(tr("農曆除夕")))
+
+        # Chinese New Year.
+        name = tr("春節")
+        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.
+            dts_observed.add(self._add_holiday_feb_28(tr("和平紀念日")))
+
+        if 1990 <= self._year <= 1999 or self._year >= 2011:
+            # Children's Day.
+            apr_4 = self._add_holiday_apr_4(tr("兒童節"))
+            if self._year != 2021:
+                dts_observed.add(apr_4)
+
+        if self._year >= 1972:
+            # Tomb Sweeping Day.
+            dts_observed.add(self._add_qingming_festival(tr("清明節")))
+
+        # Dragon Boat Festival.
+        dts_observed.add(self._add_dragon_boat_festival(tr("端午節")))
+
+        # Mid-Autumn Festival.
+        dts_observed.add(self._add_mid_autumn_festival(tr("中秋節")))
+
+        # National Day.
+        dts_observed.add(self._add_holiday_oct_10(tr("中華民國國慶日")))
+
+        if self.observed:
+            self._populate_observed(dts_observed)
+            self._populate_observed(dts_observed_forward, rule=SAT_SUN_TO_NEXT_WORKDAY, since=2010)
+
+
+class TW(Taiwan):
+    pass
+
+
+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-0.42 → holidays-0.43}/holidays/countries/thailand.py

@@ -829,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-0.42 → holidays-0.43}/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.

{holidays-0.42 → holidays-0.43}/holidays/locale/de/LC_MESSAGES/AT.po

@@ -2,7 +2,7 @@
 # Authors: ~Jhellico <jhellico@gmail.com>, (c) 2023.
 msgid ""
 msgstr ""
-"Project-Id-Version: Python Holidays 0.28\n"
+"Project-Id-Version: Python Holidays 0.42\n"
 "POT-Creation-Date: 2023-04-01 17:13+0300\n"
 "PO-Revision-Date: 2023-04-01 17:15+0300\n"
 "Last-Translator: ~Jhellico <jhellico@gmail.com>\n"
@@ -78,3 +78,27 @@ msgstr ""
 #. New Year's Eve.
 msgid "Silvester"
 msgstr ""
+
+#. St. Martin's Day.
+msgid "Hl. Martin"
+msgstr ""
+
+#. St. Joseph's Day.
+msgid "Hl. Josef"
+msgstr ""
+
+#. 1920 Carinthian plebiscite.
+msgid "Tag der Volksabstimmung"
+msgstr ""
+
+#. St. Leopold's Day.
+msgid "Hl. Leopold"
+msgstr ""
+
+#. St. Florian's Day.
+msgid "Hl. Florian"
+msgstr ""
+
+#. St. Rupert's Day.
+msgid "Hl. Rupert"
+msgstr ""