holidays 0.81__py3-none-any.whl → 0.83__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/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/islamic.py

@@ -3970,24 +3970,44 @@ class _IslamicLunar:
         2076: (DEC, 5),
     }
 
+    def __init__(self, calendar_delta_days: int = 0) -> None:
+        """
+        Args:
+            calendar_delta_days:
+                Number of days to shift all calculated holiday dates.
+                Positive values move holidays forward, negative values move them backward.
+                Defaults to 0 (no shift).
+        """
+        self.__calendar_delta_days = calendar_delta_days
+
     def _get_holiday(self, holiday: str, year: int) -> Iterable[tuple[date, bool]]:
         confirmed_dates = getattr(
             self, f"{holiday}_DATES_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", {}
         )
-        confirmed_years = getattr(
-            self, f"{holiday}_DATES_CONFIRMED_YEARS_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", ()
+        confirmed_years = _normalize_tuple(
+            getattr(
+                self, f"{holiday}_DATES_CONFIRMED_YEARS_{_CustomCalendar.CUSTOM_ATTR_POSTFIX}", ()
+            )
         )
         estimated_dates = getattr(self, f"{holiday}_DATES", {})
+        calendar_delta_days = self.__calendar_delta_days
 
         for check_year in (year - 1, year):
+            is_confirmed_year = check_year in confirmed_dates
             for dt in _normalize_tuple(
                 confirmed_dates.get(check_year, estimated_dates.get(check_year, ()))
             ):
-                is_confirmed = check_year in confirmed_dates or any(
-                    year_from <= check_year <= year_to
-                    for year_from, year_to in _normalize_tuple(confirmed_years)
+                is_confirmed = is_confirmed_year or any(
+                    year_from <= check_year <= year_to for year_from, year_to in confirmed_years
+                )
+
+                holiday_date = date(check_year, *dt)
+                yield (
+                    _timedelta(holiday_date, calendar_delta_days)
+                    if calendar_delta_days and not is_confirmed_year
+                    else holiday_date,
+                    not is_confirmed,
                 )
-                yield date(check_year, *dt), not is_confirmed
 
     def _is_long_ramadan(self, eid_al_fitr: date) -> bool:
         """Check whether the Ramadan preceding the given Eid al-Fitr date lasted 30 days.

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
@@ -283,6 +293,7 @@ from holidays.countries.vatican_city import VaticanCity, VA, VAT
 from holidays.countries.venezuela import Venezuela, VE, VEN
 from holidays.countries.vietnam import Vietnam, VN, VNM
 from holidays.countries.wallis_and_futuna import WallisAndFutuna, WF, WLF, HolidaysWF
+from holidays.countries.western_sahara import WesternSahara, EH, ESH
 from holidays.countries.yemen import Yemen, YE, YEM
 from holidays.countries.zambia import Zambia, ZM, ZMB
 from holidays.countries.zimbabwe import Zimbabwe, ZW, ZWE

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