holidays 0.79__py3-none-any.whl → 0.81__py3-none-any.whl

holidays/calendars/chinese.py

@@ -14,7 +14,7 @@ from datetime import date
 from typing import Optional
 
 from holidays.calendars.custom import _CustomCalendar
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, SEP, OCT, NOV
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, SEP, OCT, NOV, DEC
 
 CHINESE_CALENDAR = "CHINESE_CALENDAR"
 KOREAN_CALENDAR = "KOREAN_CALENDAR"
@@ -1307,6 +1307,24 @@ class _ChineseLunisolar:
         2053: (FEB, 18),
     }
 
+    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},
+        },
+        # UTC+8.
+        CHINESE_CALENDAR: {
+            "dec_21": {0: 1988, 1: 2021, 2: 2058, 3: 2091},
+            "dec_23": {3: 1947},
+        },
+        # UTC+9.
+        KOREAN_CALENDAR: {
+            "dec_21": {0: 1992, 1: 2029, 2: 2062, 3: 2099},
+            "dec_23": {3: 1955},
+        },
+    }
+
     def __init__(self, calendar: str = CHINESE_CALENDAR) -> None:
         self.__verify_calendar(calendar)
         self.__calendar = calendar
@@ -1359,6 +1377,26 @@ class _ChineseLunisolar:
     def mid_autumn_date(self, year: int, calendar=None) -> tuple[Optional[date], bool]:
         return self._get_holiday(MID_AUTUMN, year, calendar)
 
+    def winter_solstice_date(self, year: int, calendar=None) -> tuple[Optional[date], bool]:
+        """Return Winter Solstice (22nd solar term in Chinese Lunisolar calendar) date.
+
+        !!! note "Note"
+            This approximation is reliable for 1941-2099 years.
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        thresholds = self.WINTER_SOLSTICE_THRESHOLDS[calendar]
+        year_mod = year % 4
+        if year >= thresholds["dec_21"][year_mod]:
+            day = 21
+        elif year <= thresholds["dec_23"].get(year_mod, 0):
+            day = 23
+        else:
+            day = 22
+
+        return date(year, DEC, day), not (1941 <= year <= 2099)
+
 
 class _CustomChineseHolidays(_CustomCalendar, _ChineseLunisolar):
     pass

holidays/calendars/hindu.py

@@ -586,6 +586,7 @@ class _HinduLunisolar:
         2023: (NOV, 27),
         2024: (NOV, 15),
         2025: (NOV, 5),
+        2026: (NOV, 24),
         2027: (NOV, 14),
         2028: (NOV, 2),
         2029: (NOV, 21),

holidays/constants.py

@@ -42,7 +42,6 @@ ARMED_FORCES = "armed_forces"
 BANK = "bank"
 GOVERNMENT = "government"
 HALF_DAY = "half_day"
-MANDATORY = "mandatory"
 OPTIONAL = "optional"
 PUBLIC = "public"
 SCHOOL = "school"

holidays/countries/__init__.py

@@ -59,6 +59,7 @@ from holidays.countries.china import China, CN, CHN
 from holidays.countries.christmas_island import ChristmasIsland, CX, CXR
 from holidays.countries.cocos_islands import CocosIslands, CC, CCK
 from holidays.countries.colombia import Colombia, CO, COL
+from holidays.countries.comoros import Comoros, KM, COM
 from holidays.countries.congo import Congo, CG, COG
 from holidays.countries.cook_islands import CookIslands, CK, COK
 from holidays.countries.costa_rica import CostaRica, CR, CRI
@@ -76,6 +77,7 @@ from holidays.countries.ecuador import Ecuador, EC, ECU
 from holidays.countries.egypt import Egypt, EG, EGY
 from holidays.countries.el_salvador import ElSalvador, SV, SLV
 from holidays.countries.equatorial_guinea import EquatorialGuinea, GQ, GNQ
+from holidays.countries.eritrea import Eritrea, ER, ERI
 from holidays.countries.estonia import Estonia, EE, EST
 from holidays.countries.eswatini import Eswatini, SZ, SZW, Swaziland
 from holidays.countries.ethiopia import Ethiopia, ET, ETH
@@ -192,7 +194,13 @@ from holidays.countries.qatar import Qatar, QA, QAT
 from holidays.countries.reunion import Reunion, RE, REU, HolidaysRE
 from holidays.countries.romania import Romania, RO, ROU
 from holidays.countries.russia import Russia, RU, RUS
+from holidays.countries.rwanda import Rwanda, RW, RWA
 from holidays.countries.saint_barthelemy import SaintBarthelemy, BL, BLM, HolidaysBL
+from holidays.countries.saint_helena_ascension_and_tristan_da_cunha import (
+    SaintHelenaAscensionAndTristanDaCunha,
+    SH,
+    SHN,
+)
 from holidays.countries.saint_kitts_and_nevis import SaintKittsAndNevis, KN, KNA
 from holidays.countries.saint_lucia import SaintLucia, LC, LCA
 from holidays.countries.saint_martin import SaintMartin, MF, MAF, HolidaysMF
@@ -220,6 +228,7 @@ from holidays.countries.sint_maarten import SintMaarten, SX, SXM
 from holidays.countries.slovakia import Slovakia, SK, SVK
 from holidays.countries.slovenia import Slovenia, SI, SVN
 from holidays.countries.solomon_islands import SolomonIslands, SB, SLB
+from holidays.countries.somalia import Somalia, SO, SOM
 from holidays.countries.south_africa import SouthAfrica, ZA, ZAF
 from holidays.countries.south_georgia_and_the_south_sandwich_islands import (
     SouthGeorgiaAndTheSouthSandwichIslands,
@@ -227,14 +236,17 @@ from holidays.countries.south_georgia_and_the_south_sandwich_islands import (
     SGS,
 )
 from holidays.countries.south_korea import SouthKorea, KR, KOR, Korea
+from holidays.countries.south_sudan import SouthSudan, SS, SSD
 from holidays.countries.spain import Spain, ES, ESP
 from holidays.countries.sri_lanka import SriLanka, LK, LKA
+from holidays.countries.sudan import Sudan, SD, SDN
 from holidays.countries.suriname import Suriname, SR, SUR
 from holidays.countries.svalbard_and_jan_mayen import SvalbardAndJanMayen, SJ, SJM, HolidaysSJ
 from holidays.countries.sweden import Sweden, SE, SWE
 from holidays.countries.switzerland import Switzerland, CH, CHE
 from holidays.countries.syrian_arab_republic import SyrianArabRepublic, SY, SYR
 from holidays.countries.taiwan import Taiwan, TW, TWN
+from holidays.countries.tajikistan import Tajikistan, TJ, TJK
 from holidays.countries.tanzania import Tanzania, TZ, TZA
 from holidays.countries.thailand import Thailand, TH, THA
 from holidays.countries.timor_leste import TimorLeste, TL, TLS
@@ -247,6 +259,7 @@ from holidays.countries.turkey import Turkey, TR, TUR
 from holidays.countries.turkmenistan import Turkmenistan, TM, TKM
 from holidays.countries.turks_and_caicos_islands import TurksAndCaicosIslands, TC, TCA
 from holidays.countries.tuvalu import Tuvalu, TV, TUV
+from holidays.countries.uganda import Uganda, UG, UGA
 from holidays.countries.ukraine import Ukraine, UA, UKR
 from holidays.countries.united_arab_emirates import UnitedArabEmirates, AE, ARE
 from holidays.countries.united_kingdom import UnitedKingdom, GB, GBR, UK

holidays/countries/argentina.py

@@ -147,6 +147,10 @@ class Argentina(
 
     country = "AR"
     default_language = "es"
+    # %s (estimated).
+    estimated_label = tr("%s (estimado)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (observado, estimado)")
     # %s (observed).
     observed_label = tr("%s (observado)")
     # Decree-Law 2446.