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

holidays/calendars/chinese.py

@@ -1306,21 +1306,39 @@ class _ChineseLunisolar:
         2053: (FEB, 18),
     }
 
+    QINGMING_THRESHOLDS: dict[str, dict[str, dict[int, int]]] = {
+        # UTC+7.
+        VIETNAMESE_CALENDAR: {
+            "apr_4": {0: 1972, 1: 2005, 2: 2038, 3: 2067},
+            "apr_6": {2: 1906, 3: 1935},
+        },
+        # UTC+8.
+        CHINESE_CALENDAR: {
+            "apr_4": {0: 1976, 1: 2009, 2: 2042, 3: 2075},
+            "apr_6": {2: 1910, 3: 1943},
+        },
+        # UTC+9.
+        KOREAN_CALENDAR: {
+            "apr_4": {0: 1984, 1: 2017, 2: 2046, 3: 2079},
+            "apr_6": {2: 1914, 3: 1947},
+        },
+    }
+
     WINTER_SOLSTICE_THRESHOLDS: dict[str, dict[str, dict[int, int]]] = {
         # UTC+7.
         VIETNAMESE_CALENDAR: {
             "dec_21": {0: 1980, 1: 2017, 2: 2050, 3: 2083},
-            "dec_23": {3: 1943},
+            "dec_23": {2: 1910, 3: 1943},
         },
         # UTC+8.
         CHINESE_CALENDAR: {
             "dec_21": {0: 1988, 1: 2021, 2: 2058, 3: 2091},
-            "dec_23": {3: 1947},
+            "dec_23": {2: 1914, 3: 1947},
         },
         # UTC+9.
         KOREAN_CALENDAR: {
             "dec_21": {0: 1992, 1: 2029, 2: 2062, 3: 2099},
-            "dec_23": {3: 1955},
+            "dec_23": {2: 1918, 3: 1955},
         },
     }
 
@@ -1376,11 +1394,31 @@ class _ChineseLunisolar:
     def mid_autumn_date(self, year: int, calendar=None) -> tuple[date | None, bool]:
         return self._get_holiday(MID_AUTUMN, year, calendar)
 
-    def winter_solstice_date(self, year: int, calendar=None) -> tuple[date | None, bool]:
+    def qingming_date(self, year: int, calendar=None) -> tuple[date, bool]:
+        """Return Qingming Festival (5th solar term of the Chinese lunisolar calendar) date.
+
+        !!! note "Note"
+            This approximation is reliable for 1901-2099 years.
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        thresholds = self.QINGMING_THRESHOLDS[calendar]
+        year_mod = year % 4
+        if year >= thresholds["apr_4"][year_mod]:
+            day = 4
+        elif year <= thresholds["apr_6"].get(year_mod, 0):
+            day = 6
+        else:
+            day = 5
+
+        return date(year, APR, day), not (1901 <= year <= 2099)
+
+    def winter_solstice_date(self, year: int, calendar=None) -> tuple[date, bool]:
         """Return Winter Solstice (22nd solar term in Chinese Lunisolar calendar) date.
 
         !!! note "Note"
-            This approximation is reliable for 1941-2099 years.
+            This approximation is reliable for 1901-2099 years.
         """
         calendar = calendar or self.__calendar
         self.__verify_calendar(calendar)
@@ -1394,7 +1432,7 @@ class _ChineseLunisolar:
         else:
             day = 22
 
-        return date(year, DEC, day), not (1941 <= year <= 2099)
+        return date(year, DEC, day), not (1901 <= year <= 2099)
 
 
 class _CustomChineseHolidays(_CustomCalendar, _ChineseLunisolar):

holidays/calendars/hindu.py

@@ -14,9 +14,10 @@ from collections.abc import Iterable
 from datetime import date
 
 from holidays.calendars.custom import _CustomCalendar
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, AUG, SEP, OCT, NOV, DEC
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, AUG, SEP, OCT, NOV, DEC
 from holidays.helpers import _normalize_tuple
 
+BATHUKAMMA = "BATHUKAMMA"
 BUDDHA_PURNIMA = "BUDDHA_PURNIMA"
 CHHATH_PUJA = "CHHATH_PUJA"
 DIWALI = "DIWALI"
@@ -32,6 +33,7 @@ HOLI = "HOLI"
 JANMASHTAMI = "JANMASHTAMI"
 MAHA_ASHTAMI = "MAHA_ASHTAMI"
 MAHA_NAVAMI = "MAHA_NAVAMI"
+MAHARANA_PRATAP_JAYANTI = "MAHARANA_PRATAP_JAYANTI"
 MAHA_SHIVARATRI = "MAHA_SHIVARATRI"
 MAHAVIR_JAYANTI = "MAHAVIR_JAYANTI"
 MAKAR_SANKRANTI = "MAKAR_SANKRANTI"
@@ -47,6 +49,45 @@ VAISAKHI = "VAISAKHI"
 
 
 class _HinduLunisolar:
+    # Dates for Bathukamma (Mahalaya Amavasya/amavasya shraddha)
+    # [Mahalaya Amavasya](https://web.archive.org/web/20250906191235/https://www.drikpanchang.com/shraddha/tithi/amavasya-shraddha-date-time.html)
+    # [2018](https://web.archive.org/web/20250402131537/https://www.telangana.gov.in/Downloads/calendar-2018/)
+    # [2019](https://web.archive.org/web/20250508145651/https://www.telangana.gov.in/Downloads/calendar-2019/)
+    # [2020](https://web.archive.org/web/20250421174049/https://www.telangana.gov.in/downloads/calendar-2020/)
+    # [2021](https://web.archive.org/web/20250404142143/https://www.telangana.gov.in/Downloads/calendar-2021/)
+    # [2022](https://web.archive.org/web/20250217143857/https://www.telangana.gov.in/Downloads/calendar-2022/)
+    # [2023](https://web.archive.org/web/20250123180708/https://www.telangana.gov.in/Downloads/calendar-2023/)
+    # [2024](https://web.archive.org/web/20250217144536/https://www.telangana.gov.in/Downloads/calendar/)
+    # [2025](https://web.archive.org/web/20250217133450/https://www.telangana.gov.in/Downloads/calendar-2025/)
+    BATHUKAMMA_DATES = {
+        2010: (OCT, 7),
+        2011: (SEP, 27),
+        2012: (OCT, 15),
+        2013: (OCT, 4),
+        2014: (SEP, 23),
+        2015: (OCT, 12),
+        2016: (SEP, 30),
+        2017: (SEP, 19),
+        2018: (OCT, 8),
+        2019: (SEP, 28),
+        2020: (OCT, 16),
+        2021: (OCT, 6),
+        2022: (SEP, 25),
+        2023: (OCT, 14),
+        2024: (OCT, 2),
+        2025: (SEP, 21),
+        2026: (OCT, 10),
+        2027: (SEP, 29),
+        2028: (SEP, 18),
+        2029: (OCT, 7),
+        2030: (SEP, 27),
+        2031: (OCT, 15),
+        2032: (OCT, 4),
+        2033: (SEP, 23),
+        2034: (OCT, 11),
+        2035: (OCT, 1),
+    }
+
     # https://web.archive.org/web/20240804044401/https://www.timeanddate.com/holidays/india/buddha-purnima
     BUDDHA_PURNIMA_DATES = {
         2001: (APR, 30),
@@ -784,6 +825,43 @@ class _HinduLunisolar:
         2035: (OCT, 10),
     }
 
+    # Dates for Maharana Pratap Jayanti (Jyeshtha Shukla 3)
+    # [Maharana Pratap Jayanti](https://web.archive.org/web/20241212205537/https://www.drikpanchang.com/calendars/indian/jayanti/maharana-pratap/maharana-pratap-jayanti.html)
+    # [2018](https://web.archive.org/web/20251213153439/https://gad.rajasthan.gov.in/writereaddata/OLDWEBDATA/PDF/Govt_Holidays_2018_25102017.pdf)
+    # [2019](https://web.archive.org/web/20251213151532/https://gad.rajasthan.gov.in/writereaddata/OLDWEBDATA/PDF/Govt_Holidays_2019_02112018.pdf)
+    # [2020](https://web.archive.org/web/20251213151547/https://gad.rajasthan.gov.in/writereaddata/OLDWEBDATA/PDF/Govt_Holidays_2020_22112019.pdf)
+    # [2021](https://web.archive.org/web/20251213151616/https://gad.rajasthan.gov.in/writereaddata/OLDWEBDATA/PDF/holiday_calender_2021_gr6_26102020.pdf)
+    # [2022](https://web.archive.org/web/20251213151608/https://gad.rajasthan.gov.in/writereaddata/OLDWEBDATA/PDF/Govt_holidays_list_21_10_2021.pdf)
+    # [2023](https://web.archive.org/web/20251213151559/https://gad.rajasthan.gov.in/writereaddata/OLDWEBDATA/PDF/Govt_holidays_list_16_11_2022.pdf)
+    MAHARANA_PRATAP_JAYANTI_DATES = {
+        2010: (JUN, 15),
+        2011: (JUN, 4),
+        2012: (MAY, 24),
+        2013: (JUN, 11),
+        2014: (MAY, 31),
+        2015: (MAY, 20),
+        2016: (JUN, 7),
+        2017: (MAY, 28),
+        2018: (JUN, 16),
+        2019: (JUN, 6),
+        2020: (MAY, 25),
+        2021: (JUN, 13),
+        2022: (JUN, 2),
+        2023: (MAY, 22),
+        2024: (JUN, 9),
+        2025: (MAY, 29),
+        2026: (JUN, 17),
+        2027: (JUN, 7),
+        2028: (MAY, 27),
+        2029: (MAY, 15),
+        2030: (JUN, 4),
+        2031: (MAY, 24),
+        2032: (JUN, 11),
+        2033: (MAY, 31),
+        2034: (MAY, 20),
+        2035: (JUN, 8),
+    }
+
     # https://web.archive.org/web/20250323040914/https://www.timeanddate.com/holidays/india/maha-shivaratri-shivaratri
     MAHA_SHIVARATRI_DATES = {
         2001: (FEB, 21),
@@ -1408,6 +1486,9 @@ class _HinduLunisolar:
             for dt in _normalize_tuple(exact_dates.get(year, estimated_dates.get(year, ()))):
                 yield date(year, *dt), year not in exact_dates
 
+    def bathukamma_date(self, year: int) -> tuple[date | None, bool]:
+        return self._get_holiday(BATHUKAMMA, year)
+
     def buddha_purnima_date(self, year: int) -> tuple[date | None, bool]:
         return self._get_holiday(BUDDHA_PURNIMA, year)
 
@@ -1459,6 +1540,9 @@ class _HinduLunisolar:
     def maha_shivaratri_date(self, year: int) -> tuple[date | None, bool]:
         return self._get_holiday(MAHA_SHIVARATRI, year)
 
+    def maharana_pratap_jayanti_date(self, year: int) -> tuple[date | None, bool]:
+        return self._get_holiday(MAHARANA_PRATAP_JAYANTI, year)
+
     def mahavir_jayanti_date(self, year: int) -> tuple[date | None, bool]:
         return self._get_holiday(MAHAVIR_JAYANTI, year)
 

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/bangladesh.py

@@ -10,6 +10,8 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from gettext import gettext as tr
+
 from holidays.calendars.gregorian import FRI, SAT
 from holidays.groups import InternationalHolidays
 from holidays.holiday_base import HolidayBase
@@ -24,6 +26,8 @@ class Bangladesh(HolidayBase, InternationalHolidays):
     """
 
     country = "BD"
+    default_language = "bn"
+    supported_languages = ("bn", "en_US")
     weekend = {FRI, SAT}
 
     def __init__(self, *args, **kwargs):
@@ -31,26 +35,26 @@ class Bangladesh(HolidayBase, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # International Mother's language Day.
-        self._add_holiday_feb_21("International Mother's language Day")
+        # Martyrs' Day and International Mother Language Day.
+        self._add_holiday_feb_21(tr("শহীদ দিবস ও আন্তর্জাতিক মাতৃভাষা দিবস"))
 
-        # Sheikh Mujibur Rahman's Birthday and Children's Day.
-        self._add_holiday_mar_17("Sheikh Mujibur Rahman's Birthday and Children's Day")
+        # Sheikh Mujibur Rahman's Birthday.
+        self._add_holiday_mar_17(tr("জাতির পিতা বঙ্গবন্ধু শেখ মুজিবুর রহমান এর জন্মদিবস"))
 
         # Independence Day.
-        self._add_holiday_mar_26("Independence Day")
+        self._add_holiday_mar_26(tr("স্বাধীনতা দিবস"))
 
         # Bengali New Year's Day.
-        self._add_holiday_apr_14("Bengali New Year's Day")
+        self._add_holiday_apr_14(tr("পহেলা বৈশাখ"))
 
         # May Day.
-        self._add_labor_day("May Day")
+        self._add_labor_day(tr("মে দিবস"))
 
         # National Mourning Day.
-        self._add_holiday_aug_15("National Mourning Day")
+        self._add_holiday_aug_15(tr("জাতীয় শোক দিবস"))
 
         # Victory Day.
-        self._add_holiday_dec_16("Victory Day")
+        self._add_holiday_dec_16(tr("বিজয় দিবস"))
 
 
 class BD(Bangladesh):

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