holidays 0.54__py3-none-any.whl → 0.56__py3-none-any.whl

holidays/countries/malta.py

@@ -62,7 +62,7 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Started in 1987 via Act LX of 1987.
 
         if self._year >= 1987:
-            # Feast of St. Paul's Shipwreck.
+            # Feast of Saint Paul's Shipwreck.
             self._add_holiday_feb_10(tr("Il-Festa tan-Nawfraġju ta' San Pawl"))
 
         # Il-Festa ta' San Ġużepp
@@ -70,7 +70,7 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Started in 1987 via Act LX of 1987.
 
         if self._year >= 1987:
-            # Feast of St. Joseph.
+            # Feast of Saint Joseph.
             self._add_saint_josephs_day(tr("Il-Festa ta' San Ġużepp"))
 
         # Jum il-Ħelsien
@@ -107,7 +107,7 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Started in 1987 via Act LX of 1987.
 
         if self._year >= 1987:
-            # Feast of St. Peter and St. Paul.
+            # Feast of Saint Peter and Saint Paul.
             self._add_saints_peter_and_paul_day(tr("Il-Festa ta' San Pietru u San Pawl"))
 
         # Il-Festa ta' Santa Marija

holidays/countries/new_zealand.py

@@ -27,6 +27,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
     country = "NZ"
     observed_label = "%s (observed)"
     subdivisions = (
+        # ISO 3166-2: Regions and Special Island Authorities.
         # https://en.wikipedia.org/wiki/ISO_3166-2:NZ
         "AUK",  # Auckland / Tāmaki-makaurau
         "BOP",  # Bay of Plenty / Toi Moana
@@ -35,7 +36,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         "GIS",  # Gisborne / Te Tairāwhiti
         "HKB",  # Hawke's Bay / Te Matau a Māui
         "MBH",  # Marlborough
-        "MWT",  # Manawatū Whanganui
+        "MWT",  # Manawatū-Whanganui / Manawatū Whanganui
         "NSN",  # Nelson / Whakatū
         "NTL",  # Northland / Te Tai tokerau
         "OTA",  # Otago / Ō Tākou
@@ -45,27 +46,71 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         "WGN",  # Greater Wellington / Te Pane Matua Taiao
         "WKO",  # Waikato
         "WTC",  # West Coast / Te Tai o Poutini
+        # Subregions:
+        # https://www.govt.nz/browse/work/public-holidays-and-work/public-holidays-and-anniversary-dates/
+        "South Canterbury",
     )
-
+    subdivisions_aliases = {
+        # Fullnames in English and Maori, as well as HASC.
+        "Auckland": "AUK",
+        "Tāmaki-Makaurau": "AUK",
+        "AU": "AUK",
+        "Bay of Plenty": "BOP",
+        "Toi Moana": "BOP",
+        "BP": "BOP",
+        "Canterbury": "CAN",
+        "Waitaha": "CAN",
+        "CA": "CAN",
+        "Chatham Islands Territory": "CIT",
+        "Chatham Islands": "CIT",  # 1901-1994, as County
+        "Wharekauri": "CIT",
+        "CI": "CIT",
+        "Gisborne": "GIS",
+        "Te Tairāwhiti": "GIS",
+        "GI": "GIS",
+        "Hawke's Bay": "HKB",
+        "Te Matau-a-Māui": "HKB",
+        "HB": "HKB",
+        "Marlborough": "MBH",
+        "MA": "MBH",
+        "Manawatū Whanganui": "MWT",
+        "Manawatū-Whanganui": "MWT",
+        "MW": "MWT",
+        "Nelson": "NSN",
+        "Whakatū": "NSN",
+        "NE": "NSN",
+        "Northland": "NTL",
+        "Te Taitokerau": "NTL",
+        "NO": "NTL",
+        "Otago": "OTA",
+        "Ō Tākou": "OTA",
+        "OT": "OTA",
+        "Southland": "STL",
+        "Te Taiao Tonga": "STL",
+        "SO": "STL",
+        "Tasman": "TAS",
+        "Te tai o Aorere": "TAS",
+        "TS": "TAS",
+        "Taranaki": "TKI",
+        "TK": "TKI",
+        "Greater Wellington": "WGN",
+        "Te Pane Matua Taiao": "WGN",
+        "Wellington": "WGN",  # Prev. ISO code from 2010-2015.
+        "Te Whanganui-a-Tara": "WGN",  # Prev. ISO code from 2010-2015.
+        "WG": "WGN",
+        "Waikato": "WKO",
+        "WK": "WKO",
+        "West Coast": "WTC",
+        "Te Tai o Poutini": "WTC",
+        "WC": "WTC",
+    }
     _deprecated_subdivisions = (
-        "Auckland",
-        "Canterbury",
-        "Chatham Islands",
-        "Hawke's Bay",
-        "Marlborough",
-        "Nelson",
-        "New Plymouth",
-        "Northland",
-        "Otago",
-        "South Canterbury",
-        "STC",
-        "Southland",
-        "Taranaki",
-        "Waitangi",
-        "Wellington",
-        "West Coast",
-        "Westland",  # Correct name is West Coast
-        "WTL",  # Correct code is WTC
+        # Pre-1893 Naming in Previous Implementations.
+        "New Plymouth",  # 1853-1859, Now Taranaki.
+        "Westland",  # 1873-1876, Now West Coast.
+        # Unofficial Code.
+        "STC",  # For 'South Canterbury' Subregional Holidays.
+        "WTL",  # Westland, Correct code is WTC (for West Coast).
     )
 
     def __init__(self, *args, **kwargs):
@@ -186,31 +231,11 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         # Boxing Day
         self._add_observed(self._add_christmas_day_two("Boxing Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
 
-        if self.subdiv == "Auckland":
-            self._populate_subdiv_auk_public_holidays()
-        elif self.subdiv == "Canterbury":
-            self._populate_subdiv_can_public_holidays()
-        elif self.subdiv == "Chatham Islands":
-            self._populate_subdiv_cit_public_holidays()
-        elif self.subdiv == "Hawke's Bay":
-            self._populate_subdiv_hkb_public_holidays()
-        elif self.subdiv == "Marlborough":
-            self._populate_subdiv_mbh_public_holidays()
-        elif self.subdiv == "Nelson":
-            self._populate_subdiv_nsn_public_holidays()
-        elif self.subdiv == "Northland":
-            self._populate_subdiv_ntl_public_holidays()
-        elif self.subdiv == "Otago":
-            self._populate_subdiv_ota_public_holidays()
-        elif self.subdiv in {"New Plymouth", "Taranaki"}:
+        if self.subdiv == "New Plymouth":
             self._populate_subdiv_tki_public_holidays()
         elif self.subdiv == "South Canterbury":
             self._populate_subdiv_stc_public_holidays()
-        elif self.subdiv == "Southland":
-            self._populate_subdiv_stl_public_holidays()
-        elif self.subdiv == "Wellington":
-            self._populate_subdiv_wgn_public_holidays()
-        elif self.subdiv in {"West Coast", "WTL", "Westland"}:
+        elif self.subdiv in {"WTL", "Westland"}:
             self._populate_subdiv_wtc_public_holidays()
 
     def _populate_subdiv_auk_public_holidays(self):
@@ -253,7 +278,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
     def _populate_subdiv_stl_public_holidays(self):
         name = "Southland Anniversary Day"
         if self._year >= 2012:
-            self._add_holiday_2_days_past_easter(name)
+            self._add_easter_tuesday(name)
         else:
             self._add_holiday(name, self._get_nearest_monday(JAN, 17))
 

holidays/countries/philippines.py

@@ -10,89 +10,146 @@
 #  Website: https://github.com/vacanza/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.calendars import _CustomChineseHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import JAN, FEB, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
 from holidays.groups import (
     ChineseCalendarHolidays,
     ChristianHolidays,
     InternationalHolidays,
     IslamicHolidays,
+    StaticHolidays,
 )
 from holidays.holiday_base import HolidayBase
 
 
 class Philippines(
-    HolidayBase, ChineseCalendarHolidays, ChristianHolidays, InternationalHolidays, IslamicHolidays
+    HolidayBase,
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    StaticHolidays,
 ):
     """
     Philippines holidays.
 
     References:
       - https://en.wikipedia.org/wiki/Public_holidays_in_the_Philippines
+      - `Revised Administrative Code of 1987 <https://www.officialgazette.gov.ph/1987/07/25/executive-order-no-292-book-ichapter-7-regular-holidays-and-nationwide-special-days/>`_
+      - `Republic Act No. 9177 <https://www.officialgazette.gov.ph/2002/11/13/republic-act-no-9177/>`_
+      - `Republic Act No. 9492 <https://www.officialgazette.gov.ph/2007/07/24/republic-act-no-9492/>`_
+      - `Republic Act No. 9849 <https://www.officialgazette.gov.ph/2009/12/11/republic-act-no-9849/>`_
+      - `Republic Act No. 10966 <https://www.officialgazette.gov.ph/2017/12/28/republic-act-no-10966/>`_
+      - `Nationwide holidays 2018-2024 <https://www.officialgazette.gov.ph/nationwide-holidays/2018/>`_
     """
 
     country = "PH"
 
     def __init__(self, *args, **kwargs):
-        ChineseCalendarHolidays.__init__(self)
+        ChineseCalendarHolidays.__init__(self, cls=PhilippinesChineseHolidays)
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, cls=PhilippinesIslamicHolidays)
+        StaticHolidays.__init__(self, cls=PhilippinesStaticHolidays)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        if self._year <= 1987:
+            return None
+
         # New Year's Day.
         self._add_new_years_day("New Year's Day")
 
         # Chinese New Year.
-        self._add_chinese_new_years_day("Chinese New Year")
-
-        # People Power Anniversary.
-        self._add_holiday_feb_25("EDSA Revolution Anniversary")
+        if self._year >= 2012 and self._year != 2023:
+            self._add_chinese_new_years_day("Chinese New Year")
 
-        # Day of Valor.
-        self._add_holiday_apr_9("Day of Valor")
+        # EDSA People Power Revolution Anniversary.
+        if self._year >= 2016 and self._year not in {2017, 2024}:
+            dates_obs = {
+                2023: (FEB, 24),
+            }
+            self._add_holiday(
+                "EDSA People Power Revolution Anniversary", dates_obs.get(self._year, (FEB, 25))
+            )
 
         # Maundy Thursday.
         self._add_holy_thursday("Maundy Thursday")
+
         # Good Friday.
         self._add_good_friday("Good Friday")
+
         # Black Saturday.
-        self._add_holy_saturday("Black Saturday")
+        if self._year >= 2013:
+            self._add_holy_saturday("Black Saturday")
 
-        # Labour Day.
-        self._add_labor_day("Labour Day")
+        # Day of Valor.
+        dates_obs = {
+            2008: (APR, 7),
+            2009: (APR, 6),
+        }
+        self._add_holiday("Araw ng Kagitingan (Day of Valor)", dates_obs.get(self._year, (APR, 9)))
 
-        # Eid al-Fitr.
-        self._add_eid_al_fitr_day("Eid'l Fitr")
+        # Labor Day.
+        self._add_labor_day("Labor Day")
 
         # Independence Day.
-        self._add_holiday_jun_12("Independence Day")
-
-        # Eid al-Adha.
-        self._add_eid_al_adha_day("Eid'l Adha")
+        dates_obs = {
+            2007: (JUN, 11),
+            2008: (JUN, 9),
+            2010: (JUN, 14),
+        }
+        self._add_holiday("Independence Day", dates_obs.get(self._year, (JUN, 12)))
 
         # Ninoy Aquino Day.
-        self._add_holiday_aug_21("Ninoy Aquino Day")
+        dates_obs = {
+            2007: (AUG, 20),
+            2008: (AUG, 18),
+            2010: (AUG, 23),
+        }
+        self._add_holiday("Ninoy Aquino Day", dates_obs.get(self._year, (AUG, 21)))
 
         # National Heroes Day.
-        self._add_holiday_last_mon_of_aug("National Heroes Day")
+        name = "National Heroes Day"
+        if self._year >= 2007:
+            self._add_holiday_last_mon_of_aug(name)
+        else:
+            self._add_holiday_last_sun_of_aug(name)
 
         # All Saints' Day.
         self._add_all_saints_day("All Saints' Day")
 
         # Bonifacio Day.
-        self._add_holiday_nov_30("Bonifacio Day")
+        dates_obs = {
+            2008: (DEC, 1),
+            2010: (NOV, 29),
+        }
+        self._add_holiday("Bonifacio Day", dates_obs.get(self._year, (NOV, 30)))
 
-        # Immaculate Conception Day.
-        self._add_immaculate_conception_day("Immaculate Conception Day")
+        # Immaculate Conception.
+        if self._year >= 2019:
+            self._add_immaculate_conception_day("Feast of the Immaculate Conception of Mary")
 
         # Christmas Day.
         self._add_christmas_day("Christmas Day")
 
         # Rizal Day.
-        self._add_holiday_dec_30("Rizal Day")
+        dates_obs = {
+            2010: (DEC, 27),
+        }
+        self._add_holiday("Rizal Day", dates_obs.get(self._year, (DEC, 30)))
 
-        # New Year's Eve.
-        self._add_new_years_eve("New Year's Eve")
+        # Last Day of the Year.
+        if self._year not in {2021, 2022}:
+            self._add_new_years_eve("Last Day of the Year")
+
+        # Eid al-Fitr.
+        if self._year >= 2002:
+            self._add_eid_al_fitr_day("Eid'l Fitr (Feast of Ramadhan)")
+
+        # Eid al-Adha.
+        if self._year >= 2010:
+            self._add_eid_al_adha_day("Eid'l Adha (Feast of Sacrifice)")
 
 
 class PH(Philippines):
@@ -101,3 +158,135 @@ class PH(Philippines):
 
 class PHL(Philippines):
     pass
+
+
+class PhilippinesChineseHolidays(_CustomChineseHolidays):
+    LUNAR_NEW_YEAR_DATES = {
+        2012: (JAN, 23),
+        2013: (FEB, 10),
+        2014: (JAN, 31),
+        2015: (FEB, 19),
+        2016: (FEB, 8),
+        2017: (JAN, 28),
+        2018: (FEB, 16),
+        2019: (FEB, 5),
+        2020: (JAN, 25),
+        2021: (FEB, 12),
+        2022: (FEB, 1),
+        2023: (JAN, 22),
+        2024: (FEB, 10),
+    }
+
+
+class PhilippinesIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2010: (NOV, 17),
+        2011: (NOV, 7),
+        2012: (OCT, 26),
+        2013: (OCT, 15),
+        2014: (OCT, 6),
+        2015: (SEP, 25),
+        2016: (SEP, 10),
+        2017: (SEP, 2),
+        2018: (AUG, 21),
+        2019: (AUG, 12),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+        2024: (JUN, 17),
+    }
+
+    EID_AL_FITR_DATES = {
+        2002: (DEC, 6),
+        2003: (NOV, 26),
+        2004: (NOV, 14),
+        2005: (NOV, 4),
+        2006: (OCT, 24),
+        2007: (OCT, 12),
+        2008: (OCT, 1),
+        2009: (SEP, 21),
+        2010: (SEP, 10),
+        2011: (AUG, 30),
+        2012: (AUG, 20),
+        2013: (AUG, 9),
+        2014: (JUL, 29),
+        2015: (JUL, 17),
+        2016: (JUL, 7),
+        2017: (JUN, 26),
+        2018: (JUN, 15),
+        2019: (JUN, 5),
+        2020: (MAY, 25),
+        2021: (MAY, 13),
+        2022: (MAY, 3),
+        2023: (APR, 21),
+        2024: (APR, 10),
+    }
+
+
+class PhilippinesStaticHolidays:
+    additional_special = "Additional special (non-working) day"
+    election_special = "Elections special (non-working) day"
+
+    special_public_holidays = {
+        2008: (
+            (DEC, 26, additional_special),
+            (DEC, 29, additional_special),
+        ),
+        2009: (
+            (NOV, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2010: ((DEC, 24, additional_special),),
+        2012: ((NOV, 2, additional_special),),
+        2013: (
+            (NOV, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2014: (
+            (DEC, 24, additional_special),
+            (DEC, 26, additional_special),
+        ),
+        2015: (
+            (JAN, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2016: (
+            (JAN, 2, additional_special),
+            (OCT, 31, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2017: (
+            (JAN, 2, additional_special),
+            (OCT, 31, additional_special),
+        ),
+        2018: (
+            (MAY, 14, election_special),
+            (NOV, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2019: (
+            (MAY, 13, election_special),
+            (NOV, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2020: (
+            (NOV, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+        2022: (
+            (MAY, 9, election_special),
+            (OCT, 31, additional_special),
+        ),
+        2023: (
+            (JAN, 2, additional_special),
+            (OCT, 30, election_special),
+            (NOV, 2, additional_special),
+            (DEC, 26, additional_special),
+        ),
+        2024: (
+            (FEB, 9, additional_special),
+            (NOV, 2, additional_special),
+            (DEC, 24, additional_special),
+        ),
+    }

holidays/countries/portugal.py

@@ -147,7 +147,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Carnival.
         self._add_carnival_tuesday(tr("Carnaval"))
 
-        # St. Anthony's Day.
+        # Saint Anthony's Day.
         self._add_holiday_jun_13(tr("Dia de Santo António"))
 
         # Christmas Eve.
@@ -167,7 +167,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
             self._populate_optional_holidays()
 
     def _populate_subdiv_01_public_holidays(self):
-        # St. Joanna's Day.
+        # Saint Joanna's Day.
         self._add_holiday_may_12(tr("Dia de Santa Joana"))
 
     def _populate_subdiv_02_public_holidays(self):
@@ -175,7 +175,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_ascension_thursday(tr("Quinta-feira da Ascensão"))
 
     def _populate_subdiv_03_public_holidays(self):
-        # St. John's Day.
+        # Saint John's Day.
         self._add_saint_johns_day(tr("Dia de São João"))
 
     def _populate_subdiv_04_public_holidays(self):
@@ -187,11 +187,11 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_holiday_16_days_past_easter(tr("Dia de Nossa Senhora de Mércoles"))
 
     def _populate_subdiv_06_public_holidays(self):
-        # St. Elizabeth's Day.
+        # Saint Elizabeth's Day.
         self._add_holiday_jul_4(tr("Dia de Santa Isabel"))
 
     def _populate_subdiv_07_public_holidays(self):
-        # St. Peter's Day.
+        # Saint Peter's Day.
         self._add_saints_peter_and_paul_day(tr("Dia de São Pedro"))
 
     def _populate_subdiv_08_public_holidays(self):
@@ -217,7 +217,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_saint_johns_day(tr("Dia de São João"))
 
     def _populate_subdiv_14_public_holidays(self):
-        # St. Joseph's Day.
+        # Saint Joseph's Day.
         self._add_saint_josephs_day(tr("Dia de São José"))
 
     def _populate_subdiv_15_public_holidays(self):
@@ -232,7 +232,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_holiday_jun_13(tr("Dia de Santo António"))
 
     def _populate_subdiv_18_public_holidays(self):
-        # St. Matthew's Day.
+        # Saint Matthew's Day.
         self._add_holiday_sep_21(tr("Dia de São Mateus"))
 
     def _populate_subdiv_20_public_holidays(self):