Update Uzbekistan holidays, add l10n support (#1622)

README.rst

@@ -846,7 +846,7 @@ All other default values are highlighted with bold:
    * - Uzbekistan
      - UZ
      -
-     -
+     - en_US, uk, **uz**
      -
    * - Vanuatu
      - VU

holidays/countries/uzbekistan.py

@@ -9,51 +9,87 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.groups import InternationalHolidays, IslamicHolidays
-from holidays.holiday_base import HolidayBase
+from datetime import date
+from gettext import gettext as tr
 
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import JAN, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.groups import InternationalHolidays, IslamicHolidays, StaticHolidays
+from holidays.observed_holiday_base import ObservedHolidayBase, SAT_SUN_TO_NEXT_WORKDAY
 
-class Uzbekistan(HolidayBase, InternationalHolidays, IslamicHolidays):
+
+class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays):
     """
-    https://www.officeholidays.com/countries/uzbekistan
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_Uzbekistan
+        - `Labor Code 21.12.1995 <https://lex.uz/docs/-142859>`_
+        - `Labor Code 28.10.2022 <https://lex.uz/docs/-6257288>`_
     """
 
     country = "UZ"
+    default_language = "uz"
+    # Estimated label.
+    estimated_label = tr("%s (taxminiy)")
+    # %s (Observed).
+    observed_label = tr("%s (ko‘chirilgan)")
+    supported_languages = ("en_US", "uk", "uz")
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, UzbekistanIslamicHolidays)
+        StaticHolidays.__init__(self, UzbekistanStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_WORKDAY)
         super().__init__(*args, **kwargs)
 
+    def _is_observed(self, dt: date) -> bool:
+        # Commencement of the new Labor Code
+        return dt >= date(2023, APR, 30)
+
     def _populate_public_holidays(self):
-        # New Year
-        self._add_new_years_day("New Year")
+        if self._year <= 1991:
+            return None
+        dts_observed = set()
+
+        # New Year's Day.
+        dts_observed.add(self._add_new_years_day(tr("Yangi yil")))
 
-        # Women's Day
-        self._add_womens_day("Women's Day")
+        # Women's Day.
+        dts_observed.add(self._add_womens_day(tr("Xotin-qizlar kuni")))
 
-        # Nauryz Holiday
-        self._add_holiday_mar_21("Nauryz")
+        # Nowruz.
+        dts_observed.add(self._add_holiday_mar_21(tr("Navro‘z bayrami")))
 
-        # Ramadan Khait
-        # Date of observance is announced yearly, This is an estimate.
-        self._add_eid_al_fitr_day("Ramadan Khait")
+        dts_observed.add(
+            self._add_world_war_two_victory_day(
+                # Day of Memory and Honor.
+                tr("Xotira va qadrlash kuni")
+                if self._year >= 1999
+                # Victory Day.
+                else tr("G‘alaba kuni")
+            )
+        )
 
-        # Memorial Day
-        self._add_world_war_two_victory_day("Memorial Day")
+        # Independence Day.
+        dts_observed.add(self._add_holiday_sep_1(tr("Mustaqillik kuni")))
 
-        # Kurban Khait
-        # Date of observance is announced yearly, This is an estimate.
-        self._add_eid_al_adha_day("Kurban Khait")
+        if self._year >= 1997:
+            # Teachers and Instructors Day.
+            dts_observed.add(self._add_holiday_oct_1(tr("O‘qituvchi va murabbiylar kuni")))
 
-        # Independence Day
-        self._add_holiday_sep_1("Independence Day")
+        if self._year >= 1993:
+            dts_observed.add(
+                # Constitution Day.
+                self._add_holiday_dec_8(tr("O‘zbekiston Respublikasi Konstitutsiyasi kuni"))
+            )
 
-        # Teacher's Day
-        self._add_holiday_oct_1("Teacher's Day")
+        # Eid al-Fitr.
+        dts_observed.update(self._add_eid_al_fitr_day(tr("Ro‘za hayit")))
 
-        # Constitution Day
-        self._add_holiday_dec_8("Constitution Day")
+        # Eid al-Adha.
+        dts_observed.update(self._add_eid_al_adha_day(tr("Qurbon hayit")))
+
+        if self.observed and self._year >= 2023:
+            self._populate_observed(dts_observed)
 
 
 class UZ(Uzbekistan):
@@ -62,3 +98,125 @@ class UZ(Uzbekistan):
 
 class UZB(Uzbekistan):
     pass
+
+
+class UzbekistanIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2006: ((JAN, 10), (DEC, 30)),
+        2007: (DEC, 19),
+        2008: (DEC, 8),
+        2009: (NOV, 27),
+        2010: (NOV, 16),
+        2011: (NOV, 6),
+        2012: (OCT, 26),
+        2013: (OCT, 15),
+        2014: (OCT, 4),
+        2015: (SEP, 24),
+        2016: (SEP, 12),
+        2017: (SEP, 1),
+        2018: (AUG, 21),
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+    }
+
+    EID_AL_FITR_DATES = {
+        2006: (OCT, 23),
+        2007: (OCT, 13),
+        2008: (OCT, 1),
+        2009: (SEP, 21),
+        2010: (SEP, 10),
+        2011: (AUG, 31),
+        2012: (AUG, 19),
+        2013: (AUG, 9),
+        2014: (JUL, 28),
+        2015: (JUL, 18),
+        2016: (JUL, 6),
+        2017: (JUN, 26),
+        2018: (JUN, 15),
+        2019: (JUN, 5),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 21),
+    }
+
+
+class UzbekistanStaticHolidays:
+    # Date format (see strftime() Format Codes)
+    substituted_date_format = tr("%d/%m %Y")
+    # Day off (substituted from %s).
+    substituted_label = tr("Dam olish kuni (%s dan ko‘chirilgan)")
+
+    # Additional day off by Presidential decree.
+    additional_day_off = tr("Prezidentining farmoni bilan qo‘shimcha dam olish kuni")
+    special_public_holidays = {
+        2018: (
+            (JAN, 2, additional_day_off),
+            (JAN, 3, JAN, 6),
+            (MAR, 19, MAR, 17),
+            (MAR, 22, MAR, 24),
+            (MAR, 30, additional_day_off),
+            (AUG, 23, AUG, 25),
+            (AUG, 24, AUG, 26),
+            (AUG, 31, additional_day_off),
+            (SEP, 3, SEP, 8),
+            (SEP, 4, SEP, 15),
+            (DEC, 31, DEC, 29),
+        ),
+        2019: (
+            (JAN, 2, additional_day_off),
+            (JAN, 3, JAN, 5),
+            (MAR, 22, additional_day_off),
+            (JUN, 6, JUN, 1),
+            (SEP, 2, additional_day_off),
+            (SEP, 3, SEP, 7),
+            (DEC, 31, DEC, 28),
+        ),
+        2020: (
+            (JAN, 2, JAN, 4),
+            (MAR, 23, additional_day_off),
+            (AUG, 31, AUG, 29),
+        ),
+        2021: (
+            (MAR, 22, MAR, 27),
+            (MAY, 14, additional_day_off),
+            (JUL, 21, JUL, 17),
+            (JUL, 22, JUL, 24),
+            (SEP, 2, additional_day_off),
+            (SEP, 3, additional_day_off),
+            (DEC, 31, additional_day_off),
+        ),
+        2022: (
+            (JAN, 3, additional_day_off),
+            (JAN, 4, JAN, 8),
+            (MAR, 22, additional_day_off),
+            (MAR, 23, additional_day_off),
+            (MAY, 3, additional_day_off),
+            (MAY, 4, MAY, 7),
+            (JUL, 11, additional_day_off),
+            (JUL, 12, JUL, 16),
+            (SEP, 2, additional_day_off),
+        ),
+        2023: (
+            (JAN, 2, additional_day_off),
+            (JAN, 3, JAN, 7),
+            (MAR, 20, MAR, 11),
+            (MAR, 22, MAR, 25),
+            (APR, 24, additional_day_off),
+            (JUN, 29, additional_day_off),
+            (JUN, 30, additional_day_off),
+        ),
+        2024: (
+            (JAN, 2, JAN, 6),
+            (MAR, 22, additional_day_off),
+            (APR, 11, additional_day_off),
+            (APR, 12, APR, 13),
+            (JUN, 18, additional_day_off),
+            (SEP, 3, additional_day_off),
+            (DEC, 30, DEC, 14),
+            (DEC, 31, additional_day_off),
+        ),
+    }

holidays/locale/en_US/LC_MESSAGES/UZ.po

@@ -0,0 +1,80 @@
+# Uzbekistan holidays en_US localization.
+# Authors: ~Jhellico <jhellico@gmail.com>, (c) 2024.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Python Holidays 0.41\n"
+"POT-Creation-Date: 2023-12-31 21:12+0200\n"
+"PO-Revision-Date: 2024-01-02 12:46+0200\n"
+"Last-Translator: ~Jhellico <jhellico@gmail.com>\n"
+"Language-Team: Python Holidays Localization Team\n"
+"Language: en_US\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Generated-By: Lingua 4.15.0\n"
+"X-Generator: Poedit 3.4\n"
+
+#. New Year's Day.
+msgid "Yangi yil"
+msgstr "New Year's Day"
+
+#. Women's Day.
+msgid "Xotin-qizlar kuni"
+msgstr "Women's Day"
+
+#. Nowruz.
+msgid "Navro‘z bayrami"
+msgstr "Nowruz"
+
+#. Day of Memory and Honor.
+msgid "Xotira va qadrlash kuni"
+msgstr "Day of Memory and Honor"
+
+#. Victory Day.
+msgid "G‘alaba kuni"
+msgstr "Victory Day"
+
+#. Independence Day.
+msgid "Mustaqillik kuni"
+msgstr "Independence Day"
+
+#. Teachers and Instructors Day.
+msgid "O‘qituvchi va murabbiylar kuni"
+msgstr "Teachers and Instructors Day"
+
+#. Constitution Day.
+msgid "O‘zbekiston Respublikasi Konstitutsiyasi kuni"
+msgstr "Constitution Day"
+
+#. Eid al-Fitr.
+msgid "Ro‘za hayit"
+msgstr "Eid al-Fitr"
+
+#. Eid al-Adha.
+msgid "Qurbon hayit"
+msgstr "Eid al-Adha"
+
+#. Estimated label.
+#, c-format
+msgid "%s (taxminiy)"
+msgstr "%s (estimated)"
+
+#. %s (Observed).
+#, c-format
+msgid "%s (ko‘chirilgan)"
+msgstr "%s (Observed)"
+
+#. Date format (see strftime() Format Codes)
+msgid "%d/%m %Y"
+msgstr "%m/%d/%Y"
+
+#. Day off (substituted from %s).
+#, c-format
+msgid "Dam olish kuni (%s dan ko‘chirilgan)"
+msgstr "Day off (substituted from %s)"
+
+#. Additional day off by Presidential decree.
+msgid "Prezidentining farmoni bilan qo‘shimcha dam olish kuni"
+msgstr "Additional day off by Presidential decree"