holidays 0.87__py3-none-any.whl → 0.88__py3-none-any.whl

holidays/constants.py

@@ -38,6 +38,7 @@ HOLIDAY_NAME_DELIMITER = "; "  # Holiday names separator.
 # Supported holiday categories.
 ARMED_FORCES = "armed_forces"
 BANK = "bank"
+DE_FACTO = "de_facto"
 GOVERNMENT = "government"
 HALF_DAY = "half_day"
 OPTIONAL = "optional"

holidays/countries/american_samoa.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import UnitedStates
 from holidays.mixins.child_entity import ChildEntity
 
@@ -25,6 +26,7 @@ class AmericanSamoa(ChildEntity, UnitedStates):
     parent_entity = UnitedStates
     # Became a U.S. Territory since April 17th, 1900.
     start_year = 1901
+    supported_categories = (PUBLIC, UNOFFICIAL)
 
 
 class HolidaysAS(AmericanSamoa):

holidays/countries/belarus.py

@@ -148,8 +148,9 @@ class BelarusStaticHolidays:
     """Belarus special holidays.
 
     References:
-        * <https://web.archive.org/web/20241005054448/https://belarusbank.by/en/financial-institutions/11151>
-        * <https://web.archive.org/web/20241210150222/https://belarusbank.by/en/financial-institutions/11160>
+        * [2024](https://web.archive.org/web/20241005054448/https://belarusbank.by/en/financial-institutions/11151)
+        * [2025](https://web.archive.org/web/20241210150222/https://belarusbank.by/en/financial-institutions/11160)
+        * [2026](https://web.archive.org/web/20251230174418/https://belarusbank.by/en/financial-institutions/11163)
     """
 
     # Date format (see strftime() Format Codes)
@@ -300,4 +301,5 @@ class BelarusStaticHolidays:
             (JUL, 4, JUL, 12),
             (DEC, 26, DEC, 20),
         ),
+        2026: (APR, 20, APR, 25),
     }

holidays/countries/brazil.py

@@ -28,6 +28,8 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         * [Decreto n. 19.488, de 15.12.1930](https://web.archive.org/web/20241006041503/http://camara.leg.br/legin/fed/decret/1930-1939/decreto-19488-15-dezembro-1930-508040-republicacao-85201-pe.html)
         * [Lei n. 662, de 6.04.1949](https://web.archive.org/web/20240913060643/https://www2.camara.leg.br/legin/fed/lei/1940-1949/lei-662-6-abril-1949-347136-publicacaooriginal-1-pl.html)
         * [Lei n. 14.759, de 21.12.2023](https://web.archive.org/web/20250402234552/https://www2.camara.leg.br/legin/fed/lei/2023/lei-14759-21-dezembro-2023-795091-publicacaooriginal-170522-pl.html)
+        * São Paulo Capital:
+            * [Anexo Único Integrante do Decreto n. 56.756, de 4.01.2016](https://web.archive.org/web/20251224031221/https://legislacao.prefeitura.sp.gov.br/leis/decreto-56756-de-04-de-janeiro-de-2016/anexo/5ec3d7a71411926001a56c56/Anexo%20Único%20do%20Decreto%20nº%2056.756_2016.pdf)
     """
 
     country = "BR"
@@ -62,6 +64,8 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         "SE",
         "SP",
         "TO",
+        # Cities.
+        "São Paulo Capital",
     )
     subdivisions_aliases = {
         "Acre": "AC",
@@ -155,6 +159,9 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
             # Christmas Day.
             self._add_christmas_day(tr("Natal"))
 
+        if self.subdiv == "São Paulo Capital":
+            self._populate_subdiv_sao_paulo_capital_public_holidays()
+
     def _populate_optional_holidays(self):
         # Carnival.
         name = tr("Carnaval")
@@ -178,7 +185,8 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
 
     def _populate_subdiv_holidays(self):
         # Lei n. 9.093, de 12.09.1995
-        if self._year >= 1996:
+        # Lei Municipal n. 7.008, de 6.04.1967
+        if self._year >= 1996 or self.subdiv == "São Paulo Capital":
             super()._populate_subdiv_holidays()
 
     def _populate_subdiv_ac_public_holidays(self):
@@ -224,6 +232,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
             self._add_holiday_nov_20(tr("Consciência Negra"))
 
         if self._year >= 2013:
+            # Evangelical Day.
             self._add_holiday_nov_30(tr("Dia do Evangélico"))
 
     def _populate_subdiv_am_public_holidays(self):
@@ -231,6 +240,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_holiday_sep_5(tr("Elevação do Amazonas à categoria de província"))
 
         if 2010 <= self._year <= 2023:
+            # Black Awareness Day.
             self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_ap_public_holidays(self):
@@ -246,6 +256,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_holiday_sep_13(tr("Criação do Território Federal"))
 
         if 2008 <= self._year <= 2023:
+            # Black Awareness Day.
             self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_ba_public_holidays(self):
@@ -266,6 +277,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         # Founding of Brasilia.
         self._add_holiday_apr_21(tr("Fundação de Brasília"))
 
+        # Evangelical Day.
         self._add_holiday_nov_30(tr("Dia do Evangélico"))
 
     def _populate_subdiv_es_public_holidays(self):
@@ -294,6 +306,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
 
     def _populate_subdiv_mt_public_holidays(self):
         if 2003 <= self._year <= 2023:
+            # Black Awareness Day.
             self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_pa_public_holidays(self):
@@ -323,6 +336,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
             self._add_saint_georges_day(tr("São Jorge"))
 
         if 2002 <= self._year <= 2023:
+            # Black Awareness Day.
             self._add_holiday_nov_20(tr("Consciência Negra"))
 
     def _populate_subdiv_rn_public_holidays(self):
@@ -335,12 +349,15 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
             self._add_holiday_oct_3(tr("Mártires de Cunhaú e Uruaçu"))
 
     def _populate_subdiv_ro_public_holidays(self):
+        # State Creation Day.
         self._add_holiday_jan_4(tr("Criação do Estado"))
 
         if self._year >= 2002:
+            # Evangelical Day.
             self._add_holiday_jun_18(tr("Dia do Evangélico"))
 
     def _populate_subdiv_rr_public_holidays(self):
+        # State Creation Day.
         self._add_holiday_oct_5(tr("Criação do Estado"))
 
     def _populate_subdiv_rs_public_holidays(self):
@@ -372,6 +389,14 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
             # Constitutionalist Revolution.
             self._add_holiday_jul_9(tr("Revolução Constitucionalista"))
 
+    def _populate_subdiv_sao_paulo_capital_public_holidays(self):
+        self._populate_subdiv_sp_public_holidays()
+
+        # Lei Municipal n. 7.008, de 6.04.1967
+        if self._year >= 1968:
+            # São Paulo City Anniversary.
+            self._add_holiday_jan_25(tr("Aniversário da Cidade de São Paulo"))
+
     def _populate_subdiv_to_public_holidays(self):
         if self._year >= 1998:
             # Autonomy Day.
@@ -380,6 +405,7 @@ class Brazil(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         # Our Lady of Nativity.
         self._add_nativity_of_mary_day(tr("Nossa Senhora da Natividade"))
 
+        # State Creation Day.
         self._add_holiday_oct_5(tr("Criação do Estado"))
 
 

holidays/countries/chile.py

@@ -60,8 +60,7 @@ class Chile(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stati
         * [Law 19.973 (Sep 17, 2004 holiday)](https://web.archive.org/web/20250812023003/https://www.bcn.cl/leychile/navegar?idLey=19973)
         * [Law 20.450 (Sep 17, 2010 and Sep 20, 2010 holidays)](https://web.archive.org/web/20250812023308/https://www.bcn.cl/leychile/navegar?idLey=20450)
         * [Law 21.521 (eliminate Dec 31 again, after the CMF publishes a specific regulation)](https://web.archive.org/web/20240214154900/https://www.bcn.cl/leychile/navegar?idNorma=1187323&idVersion=2023-02-03)
-        * [Norma de Carácter General N° 543 de la CMF](https://web.archive.org/web/20250811111649/https://www.cmfchile.cl/normativa/ncg_543_2025.pdf)
-        * [Resolución Exenta N° 7.671 (CMF, 2025-08-01)](https://web.archive.org/web/20250811123908/https://www.cmfchile.cl/sitio/aplic/serdoc/ver_sgd.php?s567=ba5ad42feea3531a678a9db5253a9477VFdwQmVVNVVRVFJOUkZWNlRucEpORTVCUFQwPQ==&secuencia=-1&t=1754086087)
+        * [Law 21.791 (restore bank holiday on Dec 31)](https://web.archive.org/web/20251219021727/https://www.bcn.cl/leychile/navegar?idNorma=1219578&idVersion=2025-12-17)
     """
 
     country = "CL"
@@ -244,7 +243,7 @@ class Chile(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stati
         if 1957 <= self._year <= 1975:
             self._add_holiday_jun_30(name)
 
-        if 1956 <= self._year <= 2024 and self._year != 1997:
+        if 1956 <= self._year and self._year != 1997:
             self._add_holiday_dec_31(name)
 
     @property

holidays/countries/guam.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import UnitedStates
 from holidays.mixins.child_entity import ChildEntity
 
@@ -25,6 +26,7 @@ class Guam(ChildEntity, UnitedStates):
     parent_entity = UnitedStates
     # Became a U.S. Territory on April 11th, 1899.
     start_year = 1900
+    supported_categories = (PUBLIC, UNOFFICIAL)
 
 
 class HolidaysGU(Guam):

holidays/countries/macau.py

@@ -24,6 +24,8 @@ from holidays.observed_holiday_base import (
     ObservedHolidayBase,
     SUN_TO_NEXT_WORKDAY,
     SAT_SUN_TO_NEXT_WORKDAY,
+    SAT_TO_NONE,
+    SUN_TO_NONE,
 )
 
 
@@ -92,19 +94,7 @@ class Macau(
         kwargs.setdefault("observed_since", 2011)
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
-        """Macau Mandatory (Statutory) Holidays.
-
-        Decreto-Lei n.º 101/84/M - Earliest Available Version Online.
-        Decreto-Lei n.º 24/89/M - Added Ching Ming Festival.
-        Lei n.º 8/2000 - Removed Day of Portugal
-                       - Added Macao S.A.R. Establishment Day.
-                       - Moved Mid-Autumn to Day following Mid-Autumn to match Public Holidays.
-        Lei n.º 7/2008 - Consolidated with other laws, reaffirming 2000 Amendment list.
-        """
-        if self._year <= 1984:
-            return None
-
+    def _populate_common(self):
         # New Year's Day.
         self._add_new_years_day(tr("元旦"))
 
@@ -126,6 +116,21 @@ class Macau(
         # National Day of the People's Republic of China.
         self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
 
+    def _populate_public_holidays(self):
+        """Macau Mandatory (Statutory) Holidays.
+
+        Decreto-Lei n.º 101/84/M - Earliest Available Version Online.
+        Decreto-Lei n.º 24/89/M - Added Ching Ming Festival.
+        Lei n.º 8/2000 - Removed Day of Portugal
+                       - Added Macao S.A.R. Establishment Day.
+                       - Moved Mid-Autumn to Day following Mid-Autumn to match Public Holidays.
+        Lei n.º 7/2008 - Consolidated with other laws, reaffirming 2000 Amendment list.
+        """
+        if self._year <= 1984:
+            return None
+
+        self._populate_common()
+
         # Decreto-Lei n.º 24/89/M - Adds Ching Ming as a Mandatory Holiday.
         if self._year >= 1989:
             # Tomb-Sweeping Day.
@@ -150,17 +155,7 @@ class Macau(
 
     def _populate_optional_holidays(self):
         """Macau General Holidays."""
-        # New Year's Day.
-        self._add_new_years_day(tr("元旦"))
-
-        # Chinese New Year's Day.
-        self._add_chinese_new_years_day(tr("農曆正月初一"))
-
-        # The second day of Chinese New Year.
-        self._add_chinese_new_years_day_two(tr("農曆正月初二"))
-
-        # The third day of Chinese New Year.
-        self._add_chinese_new_years_day_three(tr("農曆正月初三"))
+        self._populate_common()
 
         # Tomb-Sweeping Day.
         self._add_qingming_festival(tr("清明節"))
@@ -183,21 +178,12 @@ class Macau(
             else tr("聖周星期六")
         )
 
-        # Labor Day.
-        self._add_labor_day(tr("勞動節"))
-
         # Dragon Boat Festival.
         self._add_dragon_boat_festival(tr("端午節"))
 
-        # Double Ninth Festival.
-        self._add_double_ninth_festival(tr("重陽節"))
-
         # The Day following Mid-Autumn Festival.
         self._add_mid_autumn_festival_day_two(tr("中秋節翌日"))
 
-        # National Day of the People's Republic of China.
-        self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
-
         # All Soul's Day.
         self._add_all_souls_day(tr("追思節"))
 
@@ -293,18 +279,12 @@ class Macau(
         # New Year's Day.
         dts_observed.add(self._add_new_years_day(tr("元旦")))
 
-        if self._year not in {2006, 2007, 2009, 2010, 2012, 2013, 2016, 2023}:
+        if not (
+            self._is_sunday(self._chinese_new_year) or self._is_monday(self._chinese_new_year)
+        ):
             # Chinese New Year's Eve.
             self._add_chinese_new_years_eve(begin_time_label % self.tr("農曆除夕"))
 
-        if self._year in {2006, 2007, 2010, 2013, 2014, 2017, 2018}:
-            # The fourth day of Chinese New Year.
-            self._add_chinese_new_years_day_four(tr("農曆正月初四"))
-
-        if self._year in {2014, 2015, 2017, 2018}:
-            # The fifth day of Chinese New Year.
-            self._add_chinese_new_years_day_five(tr("農曆正月初五"))
-
         if self._year >= 2019:
             # Chinese New Year's Day.
             dts_observed.add(self._add_chinese_new_years_day(tr("農曆正月初一")))
@@ -314,6 +294,17 @@ class Macau(
 
             # The third day of Chinese New Year.
             dts_observed.add(self._add_chinese_new_years_day_three(tr("農曆正月初三")))
+        else:
+            if self._is_friday(self._chinese_new_year) or self._is_weekend(self._chinese_new_year):
+                # The fourth day of Chinese New Year.
+                self._add_chinese_new_years_day_four(tr("農曆正月初四"))
+            if self._year >= 2012 and (
+                self._is_thursday(self._chinese_new_year)
+                or self._is_friday(self._chinese_new_year)
+                or self._is_saturday(self._chinese_new_year)
+            ):
+                # The fifth day of Chinese New Year.
+                self._add_chinese_new_years_day_five(tr("農曆正月初五"))
 
         # The Day before Easter.
         dts_observed.add(self._add_holy_saturday(tr("復活節前日")))
@@ -361,9 +352,12 @@ class Macau(
         dts_observed.add(self._add_christmas_day(tr("聖誕節")))
 
         # 2012's Full-Day New Year's Eve is declared discretely.
-        if self._year >= 2007 and self._year not in {2011, 2012, 2016, 2017, 2022, 2023}:
-            # New Year's Eve.
-            self._add_new_years_eve(begin_time_label % self.tr("除夕"))
+        if self._year >= 2007 and self._year != 2012:
+            self._move_holiday(
+                # New Year's Eve.
+                self._add_new_years_eve(begin_time_label % self.tr("除夕")),
+                rule=SAT_TO_NONE + SUN_TO_NONE,
+            )
 
         if self.observed:
             self.observed_label = (