holidays 0.81__tar.gz → 0.82__tar.gz

{holidays-0.81 → holidays-0.82}/CONTRIBUTORS

@@ -1,3 +1,4 @@
+Aaqil Yousuf
 Aaron Picht
 Aart Goossens
 Abdelkhalek Boukli Hacene
@@ -111,6 +112,7 @@ Nicholas Spagnoletti
 Nico Albers
 Olivier Iffrig
 Ondřej Nový
+Oriol Romaní Picas
 Osayd Abdu
 Oscar Romero
 Pablo Merino

{holidays-0.81 → holidays-0.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.81
+Version: 0.82
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -142,7 +142,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 242 country codes. The standard way to refer to a country is by using its [ISO
+We currently support 248 country codes. The standard way to refer to a country is by using its [ISO
 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes), the same used
 for domain names, and for a subdivision its [ISO 3166-2
 code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
@@ -209,7 +209,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>DZ</td>
 <td></td>
 <td><strong>ar</strong>, en_US, fr</td>
-<td></td>
+<td>CHRISTIAN, HEBREW</td>
 </tr>
 <tr>
 <td>American Samoa</td>
@@ -240,6 +240,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Antarctica</td>
+<td>AQ</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Antigua and Barbuda</td>
 <td>AG</td>
 <td></td>
@@ -387,6 +394,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Bouvet Island</td>
+<td>BV</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Brazil</td>
 <td>BR</td>
 <td>States: AC (Acre), AL (Alagoas), AM (Amazonas), AP (Amapá), BA (Bahia), CE (Ceará), DF (Distrito Federal), ES (Espírito Santo), GO (Goiás), MA (Maranhão), MG (Minas Gerais), MS (Mato Grosso do Sul), MT (Mato Grosso), PA (Pará), PB (Paraíba), PE (Pernambuco), PI (Piauí), PR (Paraná), RJ (Rio de Janeiro), RN (Rio Grande do Norte), RO (Rondônia), RR (Roraima), RS (Rio Grande do Sul), SC (Santa Catarina), SE (Sergipe), SP (São Paulo), TO (Tocantins)</td>
@@ -394,6 +408,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>OPTIONAL</td>
 </tr>
 <tr>
+<td>British Indian Ocean Territory</td>
+<td>IO</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>British Virgin Islands</td>
 <td>VG</td>
 <td></td>
@@ -842,6 +863,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>OPTIONAL</td>
 </tr>
 <tr>
+<td>Heard Island and McDonald Islands</td>
+<td>HM</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Honduras</td>
 <td>HN</td>
 <td></td>
@@ -1206,6 +1234,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Myanmar</td>
+<td>MM</td>
+<td></td>
+<td>en_US, <strong>my</strong>, th</td>
+<td></td>
+</tr>
+<tr>
 <td>Namibia</td>
 <td>NA</td>
 <td></td>
@@ -1290,6 +1325,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>GOVERNMENT, UNOFFICIAL</td>
 </tr>
 <tr>
+<td>North Korea</td>
+<td>KP</td>
+<td></td>
+<td>en_US, <strong>ko_KP</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>North Macedonia</td>
 <td>MK</td>
 <td></td>
@@ -1299,7 +1341,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <tr>
 <td>Norway</td>
 <td>NO</td>
-<td>Counties and Arctic Regions: 03 (Oslo), 11 (Rogaland), 15 (Møre og Romsdal), 18 (Nordland), 21 (Svalbard), 22 (Jan Mayen), 30 (Viken), 34 (Innlandet), 38 (Vestfold og Telemark), 42 (Agder), 46 (Vestland), 50 (Trööndelage, Trøndelag), 54 (Romssa ja Finnmárkku, Troms og Finnmark, Tromssan ja Finmarkun)</td>
+<td>Counties and Arctic Regions: 03 (Oslo), 11 (Rogaland), 15 (Møre og Romsdal), 18 (Nordland), 21 (Svalbard), 22 (Jan Mayen), 31 (Østfold), 32 (Akershus), 33 (Buskerud), 34 (Innlandet), 39 (Vestfold), 40 (Telemark), 42 (Agder), 46 (Vestland), 50 (Trööndelage, Trøndelag), 55 (Romssa, Troms, Tromssan), 56 (Finmarkun, Finnmark, Finnmárkku)</td>
 <td>en_US, <strong>no</strong>, th, uk</td>
 <td></td>
 </tr>
@@ -1608,7 +1650,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Spain</td>
 <td>ES</td>
 <td>Autonomous communities: AN (Andalucía), AR (Aragón), AS (Asturias), CB (Cantabria), CE (Ceuta), CL (Castilla y León), CM (Castilla-La Mancha), CN (Canarias), CT (Cataluña, Catalunya), EX (Extremadura), GA (Galicia), IB (Islas Baleares, Illes Balears), MC (Murcia), MD (Madrid), ML (Melilla), NC (Navarra), PV (País Vasco), RI (La Rioja), VC (Valenciana)</td>
-<td>en_US, <strong>es</strong>, uk</td>
+<td>ca, en_US, <strong>es</strong>, uk</td>
 <td></td>
 </tr>
 <tr>

{holidays-0.81 → holidays-0.82}/README.md

@@ -105,7 +105,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 242 country codes. The standard way to refer to a country is by using its [ISO
+We currently support 248 country codes. The standard way to refer to a country is by using its [ISO
 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes), the same used
 for domain names, and for a subdivision its [ISO 3166-2
 code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
@@ -172,7 +172,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>DZ</td>
 <td></td>
 <td><strong>ar</strong>, en_US, fr</td>
-<td></td>
+<td>CHRISTIAN, HEBREW</td>
 </tr>
 <tr>
 <td>American Samoa</td>
@@ -203,6 +203,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Antarctica</td>
+<td>AQ</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Antigua and Barbuda</td>
 <td>AG</td>
 <td></td>
@@ -350,6 +357,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Bouvet Island</td>
+<td>BV</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Brazil</td>
 <td>BR</td>
 <td>States: AC (Acre), AL (Alagoas), AM (Amazonas), AP (Amapá), BA (Bahia), CE (Ceará), DF (Distrito Federal), ES (Espírito Santo), GO (Goiás), MA (Maranhão), MG (Minas Gerais), MS (Mato Grosso do Sul), MT (Mato Grosso), PA (Pará), PB (Paraíba), PE (Pernambuco), PI (Piauí), PR (Paraná), RJ (Rio de Janeiro), RN (Rio Grande do Norte), RO (Rondônia), RR (Roraima), RS (Rio Grande do Sul), SC (Santa Catarina), SE (Sergipe), SP (São Paulo), TO (Tocantins)</td>
@@ -357,6 +371,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>OPTIONAL</td>
 </tr>
 <tr>
+<td>British Indian Ocean Territory</td>
+<td>IO</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>British Virgin Islands</td>
 <td>VG</td>
 <td></td>
@@ -805,6 +826,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>OPTIONAL</td>
 </tr>
 <tr>
+<td>Heard Island and McDonald Islands</td>
+<td>HM</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Honduras</td>
 <td>HN</td>
 <td></td>
@@ -1169,6 +1197,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Myanmar</td>
+<td>MM</td>
+<td></td>
+<td>en_US, <strong>my</strong>, th</td>
+<td></td>
+</tr>
+<tr>
 <td>Namibia</td>
 <td>NA</td>
 <td></td>
@@ -1253,6 +1288,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>GOVERNMENT, UNOFFICIAL</td>
 </tr>
 <tr>
+<td>North Korea</td>
+<td>KP</td>
+<td></td>
+<td>en_US, <strong>ko_KP</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>North Macedonia</td>
 <td>MK</td>
 <td></td>
@@ -1262,7 +1304,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <tr>
 <td>Norway</td>
 <td>NO</td>
-<td>Counties and Arctic Regions: 03 (Oslo), 11 (Rogaland), 15 (Møre og Romsdal), 18 (Nordland), 21 (Svalbard), 22 (Jan Mayen), 30 (Viken), 34 (Innlandet), 38 (Vestfold og Telemark), 42 (Agder), 46 (Vestland), 50 (Trööndelage, Trøndelag), 54 (Romssa ja Finnmárkku, Troms og Finnmark, Tromssan ja Finmarkun)</td>
+<td>Counties and Arctic Regions: 03 (Oslo), 11 (Rogaland), 15 (Møre og Romsdal), 18 (Nordland), 21 (Svalbard), 22 (Jan Mayen), 31 (Østfold), 32 (Akershus), 33 (Buskerud), 34 (Innlandet), 39 (Vestfold), 40 (Telemark), 42 (Agder), 46 (Vestland), 50 (Trööndelage, Trøndelag), 55 (Romssa, Troms, Tromssan), 56 (Finmarkun, Finnmark, Finnmárkku)</td>
 <td>en_US, <strong>no</strong>, th, uk</td>
 <td></td>
 </tr>
@@ -1571,7 +1613,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Spain</td>
 <td>ES</td>
 <td>Autonomous communities: AN (Andalucía), AR (Aragón), AS (Asturias), CB (Cantabria), CE (Ceuta), CL (Castilla y León), CM (Castilla-La Mancha), CN (Canarias), CT (Cataluña, Catalunya), EX (Extremadura), GA (Galicia), IB (Islas Baleares, Illes Balears), MC (Murcia), MD (Madrid), ML (Melilla), NC (Navarra), PV (País Vasco), RI (La Rioja), VC (Valenciana)</td>
-<td>en_US, <strong>es</strong>, uk</td>
+<td>ca, en_US, <strong>es</strong>, uk</td>
 <td></td>
 </tr>
 <tr>

{holidays-0.81 → holidays-0.82}/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-0.82/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-0.81 → holidays-0.82}/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-0.81 → holidays-0.82}/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.