holidays 0.80__py3-none-any.whl → 0.82__py3-none-any.whl

holidays/calendars/__init__.py

@@ -14,6 +14,7 @@
 
 from holidays.calendars.balinese_saka import _BalineseSakaLunar
 from holidays.calendars.buddhist import _BuddhistLunisolar, _CustomBuddhistHolidays
+from holidays.calendars.burmese import _BurmeseLunisolar
 from holidays.calendars.chinese import _ChineseLunisolar, _CustomChineseHolidays
 from holidays.calendars.custom import _CustomCalendar
 from holidays.calendars.gregorian import GREGORIAN_CALENDAR

holidays/calendars/burmese.py

@@ -0,0 +1,319 @@
+#  holidays
+#  --------
+#  A fast, efficient Python library for generating country, province and state
+#  specific sets of holidays on the fly. It aims to make determining whether a
+#  specific date is a holiday as fast and flexible as possible.
+#
+#  Authors: Vacanza Team and individual contributors (see CONTRIBUTORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from functools import cache
+from typing import Optional
+
+from holidays.calendars.gregorian import _timedelta
+
+MO = 1954168.050623  # Beginning of 0 ME for MMT.
+SY = 1577917828.0 / 4320000.0  # Solar year (365.2587565 days).
+
+
+class _BurmeseLunisolar:
+    """Burmese Lunisolar calendar.
+
+    References:
+        * [Algorithm, Program and Calculation of Myanmar Calendar](https://web.archive.org/web/20250510011425/http://cool-emerald.blogspot.com/2013/06/algorithm-program-and-calculation-of.html)
+    """
+
+    START_DATE = date(1939, 3, 20)  # 1 Late Tagu 1301 Burmese Era.
+    START_YEAR = 1939  # 1301 Burmese Era.
+    END_YEAR = 2100  # 1463 Burmese Era.
+
+    LITTLE_WATAT_YEARS_GREGORIAN = {
+        1939,
+        1948,
+        1955,
+        1958,
+        1966,
+        1972,
+        1974,
+        1982,
+        1988,
+        1993,
+        1999,
+        2004,
+        2012,
+        2018,
+        2020,
+        2029,
+        2034,
+        2039,
+        2045,
+        2050,
+        2056,
+        2061,
+        2069,
+        2075,
+        2077,
+        2086,
+        2091,
+        2096,
+    }
+
+    BIG_WATAT_YEARS_GREGORIAN = {
+        1942,
+        1945,
+        1950,
+        1953,
+        1961,
+        1964,
+        1969,
+        1977,
+        1980,
+        1985,
+        1991,
+        1996,
+        2001,
+        2007,
+        2010,
+        2015,
+        2023,
+        2026,
+        2031,
+        2037,
+        2042,
+        2048,
+        2053,
+        2058,
+        2064,
+        2067,
+        2072,
+        2080,
+        2083,
+        2088,
+        2094,
+        2099,
+    }
+
+    @staticmethod
+    def jdn_to_gregorian(jdn: int) -> date:
+        """Convert Julian Day Number to Gregorian date.
+
+        Args:
+            jdn: Julian Day Number.
+
+        Returns:
+            Gregorian date.
+        """
+        j = jdn - 1721119
+        y, j = divmod(4 * j - 1, 146097)
+        d = j // 4
+        j, d = divmod(4 * d + 3, 1461)
+        d = (d + 4) // 4
+        m, d = divmod(5 * d - 3, 153)
+        d = (d + 5) // 5
+        y = 100 * y + j
+        if m < 10:
+            m += 3
+        else:
+            m -= 9
+            y += 1
+
+        return date(y, m, d)
+
+    @cache
+    def _get_start_date(self, year: int) -> Optional[date]:
+        if year < self.START_YEAR or year > self.END_YEAR:
+            return None
+
+        delta_days = 354 * (year - self.START_YEAR)
+        for iter_year in range(self.START_YEAR, year):
+            if iter_year in self.LITTLE_WATAT_YEARS_GREGORIAN:
+                delta_days += 30
+            elif iter_year in self.BIG_WATAT_YEARS_GREGORIAN:
+                delta_days += 31
+
+        return _timedelta(self.START_DATE, delta_days)
+
+    def thingyan_dates(self, year: int) -> tuple[Optional[date], Optional[date]]:
+        """Calculate key dates of Thingyan (Myanmar New Year festival) - Akya day
+            and Atat day.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Akya day date, Atat day date.
+
+        """
+        if year < self.START_YEAR or year > self.END_YEAR:
+            return None, None
+
+        ja = SY * (year - 638) + MO
+        jk = (ja - 2.169918982) if year >= 1950 else (ja - 2.1675)
+
+        return self.jdn_to_gregorian(round(jk)), self.jdn_to_gregorian(round(ja))
+
+    def kason_full_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of Full Moon Day of Kason.
+
+        15th day of 2nd month (Kason).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            29 [1] + 15 - 1 = 43.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of Full Moon Day of Kason.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (start_date := self._get_start_date(year)):
+            return None
+
+        return _timedelta(start_date, +43)
+
+    def waso_full_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of Full Moon Day of Waso.
+
+        15th day of 4th month (Waso).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            Year_length - 266 [4-12] + 15 - 1 = Year_length - 252.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of Full Moon Day of Waso.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (next_year_start_date := self._get_start_date(year + 1)):
+            return None
+
+        return _timedelta(next_year_start_date, -252)
+
+    def thadingyut_full_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of Full Moon Day of Thadingyut.
+
+        15th day of 7th month (Thadingyut).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            Year_length - 177 [7-12] + 15 - 1 = Year_length - 163.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of Full Moon Day of Thadingyut.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (next_year_start_date := self._get_start_date(year + 1)):
+            return None
+
+        return _timedelta(next_year_start_date, -163)
+
+    def tazaungmon_waxing_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of 1st Waxing Day of Tazaungmon.
+
+        1st day of 8th month (Tazaungmon).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            Year_length - 148 [8-12] + 1 - 1 = Year_length - 148.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of 1st Waxing Day of Tazaungmon.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (next_year_start_date := self._get_start_date(year + 1)):
+            return None
+
+        return _timedelta(next_year_start_date, -148)
+
+    def tazaungmon_full_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of Full Moon Day of Tazaungmon.
+
+        15th day of 8th month (Tazaungmon).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            Year_length - 148 [8-12] + 15 - 1 = Year_length - 134.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of Full Moon Day of Tazaungmon.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (next_year_start_date := self._get_start_date(year + 1)):
+            return None
+
+        return _timedelta(next_year_start_date, -134)
+
+    def pyatho_waxing_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of 1st Waxing Day of Pyatho.
+
+        1st day of 10th month (Pyatho).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            Year_length - 89 [10-12] + 1 - 1 = Year_length - 89.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of 1st Waxing Day of Pyatho.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (next_year_start_date := self._get_start_date(year + 1)):
+            return None
+
+        return _timedelta(next_year_start_date, -89)
+
+    def tabaung_full_moon_date(self, year: int) -> Optional[date]:
+        """Calculate the Gregorian date of Full Moon Day of Tabaung.
+
+        15th day of 12th month (Tabaung).
+
+        To calculate, we use the following time delta:
+
+        * All years:
+            Year_length - 30 [12] + 15 - 1 = Year_length - 16.
+
+        Args:
+            year:
+                Gregorian year.
+
+        Returns:
+            Gregorian date of Full Moon Day of Tabaung.
+            `None` if the Gregorian year is out of supported range.
+        """
+        if not (next_year_start_date := self._get_start_date(year + 1)):
+            return None
+
+        return _timedelta(next_year_start_date, -16)

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

@@ -1602,8 +1602,8 @@ class _HebrewLunisolar:
         dt = getattr(self, f"{holiday}_DATES", {}).get(year, ())
         return date(year, *dt) if dt else None
 
-    def hanukkah_date(self, year: int) -> set[Optional[date]]:
-        return {self._get_holiday(HANUKKAH, y) for y in (year - 1, year)}
+    def hanukkah_date(self, year: int) -> set[date]:
+        return {dt for y in (year - 1, year) if (dt := self._get_holiday(HANUKKAH, y)) is not None}
 
     def israel_independence_date(self, year: int) -> Optional[date]:
         return self._get_holiday(INDEPENDENCE_DAY, year)

holidays/calendars/thai.py

@@ -11,7 +11,7 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from functools import lru_cache
+from functools import cache
 from typing import Optional
 
 from holidays.calendars.gregorian import _timedelta
@@ -100,6 +100,8 @@ class _ThaiLunisolar:
     References:
         * <https://web.archive.org/web/20241016080156/https://www.ninenik.com/แนวทางฟังก์ชั่น_php_อย่างง่ายกับการหาวันข้างขึ้นข้างแรม-1021.html>
         * <https://web.archive.org/web/20250119171416/https://www.myhora.com/ปฏิทิน/ปฏิทิน-พ.ศ.2560.aspx>
+        * <https://web.archive.org/web/20250302100842/https://calendar.kunthet.com/#/>
+        * [2025 Khmer Lunar Calendar](https://web.archive.org/web/20250921045847/https://static1.squarespace.com/static/67722f65f2908e531b5f326d/t/678a87776503cc3f8bc538ac/1737131904673/2025Calendar-compressed.pdf)
 
     Example:
 
@@ -293,7 +295,7 @@ class _ThaiLunisolar:
                 f"Unknown calendar name: {calendar}. Use `KHMER_CALENDAR` or `THAI_CALENDAR`."
             )
 
-    @lru_cache
+    @cache
     def _get_start_date(self, year: int) -> Optional[date]:
         """Calculate the start date of that particular Thai Lunar Calendar Year.
 
@@ -320,6 +322,51 @@ class _ThaiLunisolar:
 
         return _timedelta(_ThaiLunisolar.START_DATE, delta_days)
 
+    @cache
+    def buddhist_sabbath_dates(self, year: int) -> set[date]:
+        """Return all Buddhist Sabbath (Uposatha) days in a given Gregorian year.
+
+        This function works independently of the calendar system in use,
+        whether `THAI_CALENDAR` or `KHMER_CALENDAR`.
+
+        Args:
+            year:
+                The Gregorian year.
+
+        Returns:
+            A set of `date` objects representing all Buddhist Sabbath days in the specified
+            Gregorian year. Returns an empty set if the year is outside the supported range.
+        """
+        start_date = self._get_start_date(year)
+        if not start_date:
+            return set()
+
+        # Initializes Thai lunar month lengths.
+        months = [29, 30] * 6
+        if year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN:
+            months.insert(7, 30)
+        elif year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
+            months[6] += 1
+        # Includes first two months of the next Thai lunar year to ensure all Buddhist Sabbaths
+        # in the Gregorian year are captured.
+        months.extend([29, 30])
+
+        buddhist_sabbaths: set[date] = set()
+        day_cursor = start_date
+        for month_days in months:
+            if day_cursor.year > year:
+                break
+            # Buddhist Sabbaths: 8 Waxing, 15 Waxing, 8 Waning, 14/15 Waning.
+            for offset in (7, 14, 22, month_days - 1):
+                buddhist_sabbath = _timedelta(day_cursor, offset)
+                if buddhist_sabbath.year == year:
+                    buddhist_sabbaths.add(buddhist_sabbath)
+                elif buddhist_sabbath.year > year:
+                    break
+            day_cursor = _timedelta(day_cursor, month_days)
+
+        return buddhist_sabbaths
+
     def makha_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """Calculate the estimated Gregorian date of Makha Bucha.
 

holidays/countries/__init__.py

@@ -20,6 +20,7 @@ from holidays.countries.american_samoa import AmericanSamoa, AS, ASM, HolidaysAS
 from holidays.countries.andorra import Andorra, AD, AND
 from holidays.countries.angola import Angola, AO, AGO
 from holidays.countries.anguilla import Anguilla, AI, AIA
+from holidays.countries.antarctica import Antarctica, AQ, ATA
 from holidays.countries.antigua_and_barbuda import AntiguaAndBarbuda, AG, ATG
 from holidays.countries.argentina import Argentina, AR, ARG
 from holidays.countries.armenia import Armenia, AM, ARM
@@ -41,7 +42,9 @@ from holidays.countries.bolivia import Bolivia, BO, BOL
 from holidays.countries.bonaire_sint_eustatius_and_saba import BonaireSintEustatiusAndSaba, BQ, BES
 from holidays.countries.bosnia_and_herzegovina import BosniaAndHerzegovina, BA, BIH
 from holidays.countries.botswana import Botswana, BW, BWA
+from holidays.countries.bouvet_island import BouvetIsland, BV, BVT
 from holidays.countries.brazil import Brazil, BR, BRA
+from holidays.countries.british_indian_ocean_territory import BritishIndianOceanTerritory, IO, IOT
 from holidays.countries.british_virgin_islands import BritishVirginIslands, VG, VGB
 from holidays.countries.brunei import Brunei, BN, BRN
 from holidays.countries.bulgaria import Bulgaria, BG, BLG
@@ -111,6 +114,11 @@ from holidays.countries.guinea import Guinea, GN, GIN
 from holidays.countries.guinea_bissau import GuineaBissau, GW, GNB
 from holidays.countries.guyana import Guyana, GY, GUY
 from holidays.countries.haiti import Haiti, HT, HTI
+from holidays.countries.heard_island_and_mcdonald_islands import (
+    HeardIslandAndMcDonaldIslands,
+    HM,
+    HMD,
+)
 from holidays.countries.honduras import Honduras, HN, HND
 from holidays.countries.hongkong import HongKong, HK, HKG
 from holidays.countries.hungary import Hungary, HU, HUN
@@ -163,6 +171,7 @@ from holidays.countries.montenegro import Montenegro, ME, MNE
 from holidays.countries.montserrat import Montserrat, MS, MSR
 from holidays.countries.morocco import Morocco, MA, MOR
 from holidays.countries.mozambique import Mozambique, MZ, MOZ
+from holidays.countries.myanmar import Myanmar, MM, MMR
 from holidays.countries.namibia import Namibia, NA, NAM
 from holidays.countries.nauru import Nauru, NR, NRU
 from holidays.countries.nepal import Nepal, NP, NPL
@@ -174,6 +183,7 @@ from holidays.countries.niger import Niger, NE, NER
 from holidays.countries.nigeria import Nigeria, NG, NGA
 from holidays.countries.niue import Niue, NU, NIU
 from holidays.countries.norfolk_island import NorfolkIsland, NF, NFK
+from holidays.countries.north_korea import NorthKorea, KP, PRK
 from holidays.countries.north_macedonia import NorthMacedonia, MK, MKD
 from holidays.countries.northern_mariana_islands import NorthernMarianaIslands, MP, MNP, HolidaysMP
 from holidays.countries.norway import Norway, NO, NOR
@@ -196,6 +206,11 @@ 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
@@ -234,6 +249,7 @@ 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

holidays/countries/afghanistan.py

@@ -23,7 +23,7 @@ class Afghanistan(HolidayBase, InternationalHolidays, IslamicHolidays, PersianCa
 
     References:
         * <https://en.wikipedia.org/wiki/Public_holidays_in_Afghanistan>
-        * <https://web.archive.org/web/20250408032244/https://www.timeanddate.com/holidays/afghanistan>
+        * <https://web.archive.org/web/20250903162748/https://www.timeanddate.com/holidays/afghanistan>
         * <https://en.wikipedia.org/wiki/Workweek_and_weekend>
     """
 
@@ -131,16 +131,17 @@ class AfghanistanIslamicHolidays(_CustomIslamicHolidays):
         2021: (AUG, 19),
     }
 
-    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2014, 2024)
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2014, 2025)
     EID_AL_ADHA_DATES = {
         2014: (OCT, 5),
         2016: (SEP, 13),
         2017: (SEP, 2),
         2018: (AUG, 22),
         2024: (JUN, 17),
+        2025: (JUN, 7),
     }
 
-    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2014, 2024)
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2014, 2025)
     EID_AL_FITR_DATES = {
         2014: (JUL, 29),
         2015: (JUL, 18),
@@ -150,7 +151,7 @@ class AfghanistanIslamicHolidays(_CustomIslamicHolidays):
         2023: (APR, 22),
     }
 
-    MAWLID_DATES_CONFIRMED_YEARS = (2014, 2024)
+    MAWLID_DATES_CONFIRMED_YEARS = (2014, 2025)
     MAWLID_DATES = {
         2014: (JAN, 14),
         2015: ((JAN, 3), (DEC, 24)),
@@ -160,9 +161,10 @@ class AfghanistanIslamicHolidays(_CustomIslamicHolidays):
         2019: (NOV, 10),
         2021: (OCT, 19),
         2024: (SEP, 16),
+        2025: (SEP, 5),
     }
 
-    RAMADAN_BEGINNING_DATES_CONFIRMED_YEARS = (2014, 2024)
+    RAMADAN_BEGINNING_DATES_CONFIRMED_YEARS = (2014, 2025)
     RAMADAN_BEGINNING_DATES = {
         2014: (JUN, 29),
         2016: (JUN, 7),