holidays 0.80__tar.gz → 0.82__tar.gz

{holidays-0.80 → 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.80 → holidays-0.82}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.80
+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 240 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>
@@ -1437,6 +1479,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Saint Helena, Ascension and Tristan da Cunha</td>
+<td>SH</td>
+<td>Subdivisions: AC (Ascension), HL (Saint Helena), TA (Tristan da Cunha)</td>
+<td><strong>en_GB</strong>, en_US</td>
+<td>GOVERNMENT</td>
+</tr>
+<tr>
 <td>Saint Kitts and Nevis</td>
 <td>KN</td>
 <td></td>
@@ -1601,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>
@@ -1612,6 +1661,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>BANK, GOVERNMENT, WORKDAY</td>
 </tr>
 <tr>
+<td>Sudan</td>
+<td>SD</td>
+<td></td>
+<td><strong>ar_SD</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Suriname</td>
 <td>SR</td>
 <td></td>

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

@@ -105,7 +105,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 240 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>
@@ -1400,6 +1442,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Saint Helena, Ascension and Tristan da Cunha</td>
+<td>SH</td>
+<td>Subdivisions: AC (Ascension), HL (Saint Helena), TA (Tristan da Cunha)</td>
+<td><strong>en_GB</strong>, en_US</td>
+<td>GOVERNMENT</td>
+</tr>
+<tr>
 <td>Saint Kitts and Nevis</td>
 <td>KN</td>
 <td></td>
@@ -1564,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>
@@ -1575,6 +1624,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>BANK, GOVERNMENT, WORKDAY</td>
 </tr>
 <tr>
+<td>Sudan</td>
+<td>SD</td>
+<td></td>
+<td><strong>ar_SD</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Suriname</td>
 <td>SR</td>
 <td></td>

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