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

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):