holidays 0.68__py3-none-any.whl → 0.70__py3-none-any.whl

holidays/countries/taiwan.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -31,6 +31,7 @@ from holidays.calendars.gregorian import (
     SAT,
     SUN,
 )
+from holidays.constants import GOVERNMENT, OPTIONAL, PUBLIC, SCHOOL, WORKDAY
 from holidays.groups import ChineseCalendarHolidays, InternationalHolidays, StaticHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
@@ -44,33 +45,38 @@ CHILDRENS_DAY_RULE = ObservedRule({MON: +1, TUE: -1, WED: -1, THU: +1, FRI: -1,
 
 
 class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Taiwan holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan
-        - `2025 <https://www.dgpa.gov.tw/en/information?uid=353&pid=11979>`_
-        - `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>`_
+        * <https://zh.wikipedia.org/wiki/中華民國節日與歲時列表>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan>
+
+    Commemorative Day and Day Implementation Method Amendments:
+        * [Ministry of Interior (87) Order No. 8706459](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國87年))
+        * [Ministry of Interior (88) Order No. 8897074](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國88年))
+        * [Ministry of Interior (89) Order No. 8972185](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國89年2月))
+        * [Ministry of Interior (89) Order No. 8962562](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國89年12月))
+        * [Ministry of Interior Order No. 0950045320](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20060309&lser=001)
+        * [Ministry of Interior Order No. 0960110433](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20070711&lser=001)
+        * [Ministry of Interior Order No. 0960131407](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20070711&lser=001)
+        * [Ministry of Interior Order No. 0960155673](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20071003&lser=001)
+        * [Ministry of Interior Order No. 0990212117](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20101102&lser=001)
+        * [Ministry of Interior Order No. 1010307327 and 1030128812](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20120925&lser=001)
+        * [Ministry of Interior Order No. 1030182404](https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=D0020033)
+
+    Checked With:
+        * [DGPA Work Calendar (1998-2025; Chinese)](https://www.dgpa.gov.tw/informationlist?uid=30)
+        * [DGPA Work Calendar (2001-2025; English)](https://www.dgpa.gov.tw/en/informationlist?uid=353)
     """
 
     country = "TW"
     # %s (observed).
     observed_label = tr("%s（慶祝）")
     default_language = "zh_TW"
+    supported_categories = (GOVERNMENT, OPTIONAL, PUBLIC, SCHOOL, WORKDAY)
     supported_languages = ("en_US", "th", "zh_CN", "zh_TW")
-    start_year = 1912
+    # Ministry of Interior (87) Order No. 8706459.
+    start_year = 1998
 
     def __init__(self, *args, **kwargs):
         ChineseCalendarHolidays.__init__(self)
@@ -82,9 +88,18 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
     def _populate_observed(
         self, dts: set[date], rule: ObservedRule = None, since: int = 2015
     ) -> None:
+        """
+        Taiwan's General Observance Rule first started in 2015 as per
+        decreed in 內政部台內民字第1030182404號令.
+
+        Children's Day Special Observance Rule first started in 2012 as per
+        decreed in 內政部台內民字第1010307327號令 - as this doesn't affect 2011 ones,
+        as such the logic is simplified.
+        """
         if self._year < since:
             return None
 
+        # Children's Day.
         childrens_day = self.tr("兒童節")
         for dt in sorted(dts):
             names = self.get_list(dt)
@@ -92,7 +107,7 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
                 self._add_observed(
                     dt,
                     name,
-                    # Children's Day falls on the same day as Tomb Sweeping Day.
+                    # Children's Day falls on the same day as Tomb-Sweeping Day.
                     CHILDRENS_DAY_RULE if name == childrens_day and len(names) > 1 else rule,
                 )
 
@@ -115,17 +130,15 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
         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("和平紀念日")))
+        # Peace Memorial Day.
+        dts_observed.add(self._add_holiday_feb_28(tr("和平紀念日")))
 
-        if 1990 <= self._year <= 1999 or self._year >= 2011:
+        if self._year >= 2011:
             # Children's Day.
             dts_observed.add(self._add_holiday_apr_4(tr("兒童節")))
 
-        if self._year >= 1972:
-            # Tomb Sweeping Day.
-            dts_observed.add(self._add_qingming_festival(tr("清明節")))
+        # Tomb-Sweeping Day.
+        dts_observed.add(self._add_qingming_festival(tr("民族掃墓節")))
 
         # Dragon Boat Festival.
         dts_observed.add(self._add_dragon_boat_festival(tr("端午節")))
@@ -134,11 +147,112 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
         dts_observed.add(self._add_mid_autumn_festival(tr("中秋節")))
 
         # National Day.
-        dts_observed.add(self._add_holiday_oct_10(tr("中華民國國慶日")))
+        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)
+            # While Chinese New Year special observances rule weren't officially decreed
+            # until 2015, this was de facto implemented by the DGPA since at least 2003.
+            self._populate_observed(dts_observed_forward, rule=SAT_SUN_TO_NEXT_WORKDAY, since=2003)
+
+    def _populate_school_holidays(self):
+        if self._year <= 2000:
+            # Founding Day of the Republic of China.
+            self._add_new_years_day_two(tr("中華民國開國紀念日"))
+
+            # Confucius' Birthday.
+            self._add_holiday_sep_28(tr("孔子誕辰紀念日"))
+
+            # Taiwan Retrocession Day.
+            self._add_holiday_oct_25(tr("臺灣光復節"))
+
+            # Late President Chiang Kai-shek's Birthday.
+            self._add_holiday_oct_31(tr("先總統　蔣公誕辰紀念日"))
+
+            # Dr. Sun Yat-sen's Birthday.
+            self._add_holiday_nov_12(tr("國父誕辰紀念日"))
+
+            # Constitution Day.
+            self._add_holiday_dec_25(tr("行憲紀念日"))
+
+    def _populate_government_holidays(self):
+        self._populate_school_holidays()
+
+        if self._year <= 2000:
+            # Revolutionary Martyrs Memorial Day.
+            self._add_holiday_mar_29(tr("革命先烈紀念日"))
+
+    def _populate_optional_holidays(self):
+        # Labor Day.
+        self._add_labor_day(tr("勞動節"))
+
+        # Armed Forces Day.
+        self._add_holiday_sep_3(tr("軍人節"))
+
+    def _populate_workday_holidays(self):
+        # Dr. Sun Yat-sen's Memorial Day.
+        self._add_holiday_mar_12(tr("國父逝世紀念日"))
+
+        # Arbor Day.
+        self._add_holiday_mar_12(tr("植樹節"))
+
+        # Youth Day.
+        self._add_holiday_mar_29(tr("青年節"))
+
+        # Teacher's Day.
+        self._add_holiday_sep_28(tr("教師節"))
+
+        # Chinese Cultural Renaissance Day.
+        self._add_holiday_nov_12(tr("中華文化復興節"))
+
+        # Women's Day.
+        self._add_womens_day(tr("婦女節"))
+
+        if self._year <= 2007:
+            # Late President Chiang Kai-shek's Memorial Day.
+            self._add_qingming_festival(tr("先總統蔣公逝世紀念日"))
+
+        if self._year <= 2010:
+            # Children's Day.
+            self._add_holiday_apr_4(tr("兒童節"))
+
+        if self._year >= 2000:
+            # The Buddha's Birthday.
+            self._add_chinese_birthday_of_buddha(tr("佛陀誕辰紀念日"))
+
+        if self._year >= 2001:
+            # Taoism Day.
+            self._add_chinese_new_years_day(tr("道教節"))
+
+            # Revolutionary Martyrs Memorial Day.
+            self._add_holiday_mar_29(tr("革命先烈紀念日"))
+
+            # Confucius' Birthday.
+            self._add_holiday_sep_28(tr("孔子誕辰紀念日"))
+
+            # Taiwan Retrocession Day.
+            self._add_holiday_oct_25(tr("臺灣光復節"))
+
+            # Dr. Sun Yat-sen's Birthday.
+            self._add_holiday_nov_12(tr("國父誕辰紀念日"))
+
+            # Constitution Day.
+            self._add_holiday_dec_25(tr("行憲紀念日"))
+
+            if self._year <= 2006:
+                # Late President Chiang Kai-shek's Birthday.
+                self._add_holiday_oct_31(tr("先總統　蔣公誕辰紀念日"))
+
+        if self._year >= 2006:
+            # Anti-Aggression Day.
+            self._add_holiday_mar_14(tr("反侵略日"))
+
+        if self._year >= 2008:
+            # Commemoration Day of the Lifting of Martial Law.
+            self._add_holiday_jul_15(tr("解嚴紀念日"))
+
+            # Taiwan United Nations Day.
+            self._add_united_nations_day(tr("臺灣聯合國日"))
 
 
 class TW(Taiwan):
@@ -150,14 +264,67 @@ class TWN(Taiwan):
 
 
 class TaiwanStaticHolidays:
+    """Taiwan special holidays.
+
+    DGPA, Executive Yuan Work Calendars:
+        * [1998](https://www.dgpa.gov.tw/information?uid=30&pid=4979)
+        * [1999](https://www.dgpa.gov.tw/information?uid=30&pid=4978)
+        * [2000](https://www.dgpa.gov.tw/information?uid=30&pid=4977)
+        * [2001](https://www.dgpa.gov.tw/en/information?uid=353&pid=6199)
+        * [2002](https://www.dgpa.gov.tw/en/information?uid=353&pid=6198)
+        * [2003](https://www.dgpa.gov.tw/en/information?uid=353&pid=6197)
+        * [2004](https://www.dgpa.gov.tw/en/information?uid=353&pid=6196)
+        * [2005](https://www.dgpa.gov.tw/en/information?uid=353&pid=6195)
+        * [2006](https://www.dgpa.gov.tw/en/information?uid=353&pid=6192)
+        * [2007](https://www.dgpa.gov.tw/en/information?uid=353&pid=6194)
+        * [2008](https://www.dgpa.gov.tw/en/information?uid=353&pid=6191)
+        * [2009](https://www.dgpa.gov.tw/en/information?uid=353&pid=6190)
+        * [2010](https://www.dgpa.gov.tw/en/information?uid=353&pid=6189)
+        * [2011](https://www.dgpa.gov.tw/en/information?uid=353&pid=6188)
+        * [2012](https://www.dgpa.gov.tw/en/information?uid=353&pid=6187)
+        * [2013](https://www.dgpa.gov.tw/en/information?uid=353&pid=6186)
+        * [2014](https://www.dgpa.gov.tw/en/information?uid=353&pid=6183)
+        * [2015](https://www.dgpa.gov.tw/en/information?uid=353&pid=6182)
+        * [2016](https://www.dgpa.gov.tw/en/information?uid=353&pid=6180)
+        * [2017](https://www.dgpa.gov.tw/en/information?uid=353&pid=6178)
+        * [2018](https://www.dgpa.gov.tw/en/information?uid=353&pid=7730)
+        * [2019](https://www.dgpa.gov.tw/en/information?uid=353&pid=8178)
+        * [2020](https://www.dgpa.gov.tw/en/information?uid=353&pid=9724)
+        * [2021](https://www.dgpa.gov.tw/en/information?uid=353&pid=10181)
+        * [2022](https://www.dgpa.gov.tw/en/information?uid=353&pid=10659)
+        * [2023](https://www.dgpa.gov.tw/en/information?uid=353&pid=11016)
+        * [2024](https://www.dgpa.gov.tw/en/information?uid=353&pid=11402)
+        * [2025](https://www.dgpa.gov.tw/en/information?uid=353&pid=11979)
+    """
+
     # Date format (see strftime() Format Codes).
     substituted_date_format = tr("%Y-%m-%d")
+
     # Day off (substituted from %s).
     substituted_label = tr("休息日（%s日起取代）")
 
+    # Women's Day.
+    womens_day = tr("婦女節")
+
+    # Children's Day.
     childrens_day = tr("兒童節")
 
     special_public_holidays = {
+        2000: (APR, 3, APR, 8),
+        2001: (JAN, 22, JAN, 20),
+        2005: (FEB, 7, FEB, 5),
+        2006: (OCT, 9, OCT, 14),
+        2007: (
+            (FEB, 23, MAR, 3),
+            (APR, 6, APR, 14),
+            (JUN, 18, JUN, 23),
+            (SEP, 24, SEP, 29),
+        ),
+        2009: (
+            (JAN, 2, JAN, 10),
+            (JAN, 30, JAN, 17),
+            (MAY, 29, JUN, 6),
+        ),
         2010: (FEB, 19, FEB, 6),
         2012: (
             (JAN, 27, FEB, 4),
@@ -209,7 +376,39 @@ class TaiwanStaticHolidays:
         2024: (FEB, 8, FEB, 17),
         2025: (JAN, 27, FEB, 8),
     }
-
+    # Prior to 2001, Women's Day and Children's Day holidays were given on
+    # the day before the Tomb-Sweeping Day.
+    special_optional_holidays_observed = {
+        1998: (
+            (APR, 4, childrens_day),
+            (APR, 4, womens_day),
+        ),
+        1999: (
+            (APR, 4, childrens_day),
+            (APR, 4, womens_day),
+        ),
+        2000: (
+            (APR, 3, childrens_day),
+            (APR, 3, womens_day),
+            # Armed Forces Day.
+            (SEP, 4, tr("軍人節")),
+        ),
+    }
+    # The Buddha's Birthday was observed on 2nd Sunday of May in 2000.
     special_public_holidays_observed = {
+        1998: (
+            # Chinese New Year.
+            (JAN, 31, tr("春節")),
+            # Tomb-Sweeping Day.
+            (APR, 6, tr("民族掃墓節")),
+        ),
+        1999: (
+            # Founding Day of the Republic of China.
+            (JAN, 2, tr("中華民國開國紀念日")),
+            # Dragon Boat Festival.
+            (JUN, 19, tr("端午節")),
+        ),
+        # The Buddha's Birthday.
+        2000: (MAY, 14, tr("佛陀誕辰紀念日")),
         2013: (APR, 5, childrens_day),
     }

holidays/countries/tanzania.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -27,35 +27,34 @@ from holidays.holiday_base import HolidayBase
 class Tanzania(
     HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays, StaticHolidays
 ):
-    """
+    """Tanzania holidays.
+
     References:
-    - https://old.tanzlii.org/tz/legislation/act/1962/48/  # 1962
-    - https://old.tanzlii.org/tz/legislation/act/1964/52/  # 1964
-    - https://old.tanzlii.org/tz/legislation/act/1966/39/  # 1966
-    - 1993: https://www.parliament.go.tz/polis/uploads/bills/acts/1566639469-The%20Written%20Laws%20(Miscellaneous%20Amendments)%20Act,%201993.pdf
-    - 1994: https://www.parliament.go.tz/polis/uploads/bills/acts/1566638051-The%20Written%20Laws%20(Miscellaneous%20Amendments)%20(No.%202)%20Act,%201994.pdf
-    - 2002: http://parliament.go.tz/polis/uploads/bills/acts/1454076376-ActNo-25-2002.pdf
-    - https://en.wikipedia.org/wiki/Public_holidays_in_Tanzania
-    - http://mytanzaniatimes.blogspot.com/2014/08/holiday-nane-nane-farmers-day-in.html
-    - https://www.theeastafrican.co.ke/tea/business/tanzania-declares-public-holiday-on-census-day-3918836
-    - https://www.dw.com/en/samia-suluhu-hassan-who-is-tanzanias-new-president/a-56932264
+        * [1962](https://old.tanzlii.org/tz/legislation/act/1962/48/)
+        * [1964](https://old.tanzlii.org/tz/legislation/act/1964/52/)
+        * [1966](https://old.tanzlii.org/tz/legislation/act/1966/39/)
+        * [1993](https://www.parliament.go.tz/polis/uploads/bills/acts/1566639469-The%20Written%20Laws%20(Miscellaneous%20Amendments)%20Act,%201993.pdf)
+        * [1994](https://www.parliament.go.tz/polis/uploads/bills/acts/1566638051-The%20Written%20Laws%20(Miscellaneous%20Amendments)%20(No.%202)%20Act,%201994.pdf)
+        * [2002](http://parliament.go.tz/polis/uploads/bills/acts/1454076376-ActNo-25-2002.pdf)
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Tanzania>
+        * <http://mytanzaniatimes.blogspot.com/2014/08/holiday-nane-nane-farmers-day-in.html>
+        * <https://www.theeastafrican.co.ke/tea/business/tanzania-declares-public-holiday-on-census-day-3918836>
+        * <https://www.dw.com/en/samia-suluhu-hassan-who-is-tanzanias-new-president/a-56932264>
 
     Checked With:
-    - 2023: https://www.bot.go.tz/webdocs/Other/2023%20public%20holidays.pdf
-    - 2022: https://www.bot.go.tz/webdocs/Other/PUBLIC%20HOLIDAYS%202022.pdf
-    - 2021: https://www.bot.go.tz/webdocs/Other/PUBLIC%20HOLIDAYS%202021.pdf
-    - 2020: https://www.bot.go.tz/webdocs/Other/PUBLIC%20HOLIDAYS%202020.pdf
-    - 2018: https://issamichuzi.blogspot.com/2017/11/sikukuu-za-kitaifa-zenye-mapumziko-kwa.html
-    - from 2013 onwards: https://www.timeanddate.com/holidays/tanzania/
+        * [2023](https://www.bot.go.tz/webdocs/Other/2023%20public%20holidays.pdf)
+        * [2022](https://www.bot.go.tz/webdocs/Other/PUBLIC%20HOLIDAYS%202022.pdf)
+        * [2021](https://www.bot.go.tz/webdocs/Other/PUBLIC%20HOLIDAYS%202021.pdf)
+        * [2020](https://www.bot.go.tz/webdocs/Other/PUBLIC%20HOLIDAYS%202020.pdf)
+        * [2018](https://issamichuzi.blogspot.com/2017/11/sikukuu-za-kitaifa-zenye-mapumziko-kwa.html)
+        * [from 2013 onwards](https://www.timeanddate.com/holidays/tanzania/)
 
     Limitations:
-
-    - Only works from 1994 onwards due to the lack of sources for certain legislation:
-        Government Notices No. 79 of 1977
-        Government Notices No. 300 of 1985
-        Government Notices No. 296 of 1994
-
-    - Exact Islamic holidays dates are only available for 2013-2023; the rest are estimates.
+        * Only works from 1994 onwards due to the lack of sources for certain legislation:
+            * Government Notices No. 79 of 1977
+            * Government Notices No. 300 of 1985
+            * Government Notices No. 296 of 1994
+        * Exact Islamic holidays dates are only available for 2013-2023; the rest are estimates.
     """
 
     country = "TZ"
@@ -67,10 +66,18 @@ class Tanzania(
     # Written Law (Miscellaneous Amendments) (No. 2) Act, 1994.
     start_year = 1994
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, cls=TanzaniaIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=TanzaniaIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, TanzaniaStaticHolidays)
         super().__init__(*args, **kwargs)