holidays 0.79__py3-none-any.whl → 0.81__py3-none-any.whl

holidays/countries/uganda.py

@@ -0,0 +1,101 @@
+#  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 holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Uganda(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
+    """Uganda holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Uganda>
+        * [Public Holidays Act, Cap. 255](https://web.archive.org/web/20250621140041/https://ulii.org/akn/ug/act/1965/23/eng@2000-12-31)
+        * [National Events and Calendar](https://web.archive.org/web/20250618053410/https://www.vicepresident.go.ug/national-events-and-calender/)
+        * [National Heroes Day](https://web.archive.org/web/20230622162351/https://publicholidays.africa/uganda/national-heroes-day/)
+        * [NRM Liberation Day](https://web.archive.org/web/20240124064853/https://thenilewires.com/38th-nrm-a-liberation-day-celebrations-minister-outlines-nrm-achievements/)
+        * [Archbishop Janani Luwum Day](https://web.archive.org/web/20200805133919/https://www.newvision.co.ug/news/1417242/uganda-declared-february-archbishop-janani-luwum-public-holiday)
+        * [School Calendar 2024](https://web.archive.org/web/20240519021615/https://www.education.go.ug/wp-content/uploads/2023/11/SCHOOL-CALENDAR.pdf)
+        * [Public Holidays 2025](https://web.archive.org/web/20250710193157/https://publicholidays.co.ug/)
+    """
+
+    country = "UG"
+    # %s (estimated).
+    estimated_label = "%s (estimated)"
+    # Uganda gained independence from the United Kingdom on October 9, 1962.
+    start_year = 1963
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        if self._year >= 1987:
+            # NRM Liberation Day.
+            self._add_holiday_jan_26("NRM Liberation Day")
+
+        if self._year >= 2016:
+            # Archbishop Janani Luwum Day.
+            self._add_holiday_feb_16("Archbishop Janani Luwum Day")
+
+        # Women's Day.
+        self._add_womens_day("Women's Day")
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        # Labor Day.
+        self._add_labor_day("Labour Day")
+
+        # Uganda Martyrs' Day.
+        self._add_holiday_jun_3("Uganda Martyrs' Day")
+
+        if self._year >= 2001:
+            # National Heroes' Day.
+            self._add_holiday_jun_9("National Heroes' Day")
+
+        # Independence Day.
+        self._add_holiday_oct_9("Independence Day")
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
+
+        # Boxing Day.
+        self._add_christmas_day_two("Boxing Day")
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day("Eid al-Fitr")
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day("Eid al-Adha")
+
+
+class UG(Uganda):
+    pass
+
+
+class UGA(Uganda):
+    pass

holidays/countries/vietnam.py

@@ -54,6 +54,10 @@ class Vietnam(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHoliday
     """
 
     country = "VN"
+    # %s (estimated).
+    estimated_label = tr("%s (dự kiến)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (nghỉ bù, dự kiến)")
     # %s (observed).
     observed_label = tr("%s (nghỉ bù)")
     default_language = "vi"

holidays/financial/__init__.py

@@ -15,4 +15,9 @@
 from holidays.financial.brasil_bolsa_balcao import BrasilBolsaBalcao, BVMF, B3
 from holidays.financial.european_central_bank import EuropeanCentralBank, XECB, ECB, TAR
 from holidays.financial.ice_futures_europe import ICEFuturesEurope, IFEU
+from holidays.financial.national_stock_exchange_of_india import (
+    NationalStockExchangeOfIndia,
+    XNSE,
+    NSE,
+)
 from holidays.financial.ny_stock_exchange import NewYorkStockExchange, XNYS, NYSE

holidays/financial/national_stock_exchange_of_india.py

@@ -0,0 +1,169 @@
+#  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 gettext import gettext as tr
+
+from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import MAR, APR, MAY, JUN, JUL, AUG
+from holidays.groups import ChristianHolidays, HinduCalendarHolidays, IslamicHolidays
+from holidays.observed_holiday_base import ObservedHolidayBase, SAT_TO_NONE, SUN_TO_NONE
+
+
+class NationalStockExchangeOfIndia(
+    ObservedHolidayBase, HinduCalendarHolidays, ChristianHolidays, IslamicHolidays
+):
+    """National Stock Exchange of India (NSE) holidays.
+
+    References:
+        * <https://web.archive.org/web/20250821175252/https://www.nseindia.com/resources/exchange-communication-circulars>
+
+    Historical data:
+        * [2022](https://web.archive.org/web/20250821071611/https://nsearchives.nseindia.com/content/circulars/CMTR50560.pdf)
+        * [2023](https://web.archive.org/web/20250821071635/https://nsearchives.nseindia.com/content/circulars/CMTR54757.pdf)
+        * [2024](https://web.archive.org/web/20250821071650/https://nsearchives.nseindia.com/content/circulars/CMTR59722.pdf)
+        * [2025](https://web.archive.org/web/20250624132016/https://nsearchives.nseindia.com/content/circulars/CMTR65587.pdf)
+    """
+
+    market = "XNSE"
+    default_language = "en_IN"
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
+    supported_languages = ("en_IN", "en_US", "hi")
+    start_year = 2001
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        ChristianHolidays.__init__(self)
+        HinduCalendarHolidays.__init__(self, cls=NationalStockExchangeOfIndiaHinduHolidays)
+        IslamicHolidays.__init__(
+            self,
+            cls=NationalStockExchangeOfIndiaIslamicHolidays,
+            show_estimated=islamic_show_estimated,
+        )
+        kwargs.setdefault("observed_rule", SAT_TO_NONE + SUN_TO_NONE)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Republic Day.
+        self._move_holiday(self._add_holiday_jan_26(tr("Republic Day")))
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Dr. Baba Saheb Ambedkar Jayanti.
+        self._move_holiday(self._add_holiday_apr_14(tr("Dr. Baba Saheb Ambedkar Jayanti")))
+
+        # Maharashtra Day.
+        self._move_holiday(self._add_holiday_may_1(tr("Maharashtra Day")))
+
+        # Independence Day.
+        self._move_holiday(self._add_holiday_aug_15(tr("Independence Day")))
+
+        # Mahatma Gandhi Jayanti.
+        self._move_holiday(self._add_holiday_oct_2(tr("Mahatma Gandhi Jayanti")))
+
+        # Christmas Day.
+        self._move_holiday(self._add_christmas_day(tr("Christmas Day")))
+
+        # Hindu Calendar Holidays.
+
+        # Maha Shivaratri.
+        self._move_holiday(self._add_maha_shivaratri(tr("Maha Shivaratri")))
+
+        # Holi.
+        self._move_holiday(self._add_holi(tr("Holi")))
+
+        # Ram Navami.
+        self._move_holiday(self._add_ram_navami(tr("Ram Navami")))
+
+        # Mahavir Jayanti.
+        self._move_holiday(self._add_mahavir_jayanti(tr("Mahavir Jayanti")))
+
+        # Ganesh Chaturthi.
+        self._move_holiday(self._add_ganesh_chaturthi(tr("Ganesh Chaturthi")))
+
+        # Dussehra.
+        self._move_holiday(self._add_dussehra(tr("Dussehra")))
+
+        # Diwali Laxmi Pujan.
+        self._move_holiday(self._add_gau_krida(tr("Diwali Laxmi Pujan")))
+
+        # Diwali Balipratipada.
+        name = tr("Diwali Balipratipada")
+        # NSE's calendar adds an extra-day gap in 2022–2023
+        # between Diwali Laxmi Pujan and Diwali Balipratipada.
+        self._move_holiday(
+            self._add_bhai_dooj(name)
+            if self._year in {2022, 2023}
+            else self._add_govardhan_puja(name)
+        )
+
+        # Guru Nanak Jayanti.
+        self._move_holiday(self._add_guru_nanak_jayanti(tr("Guru Nanak Jayanti")))
+
+        # Islamic Calendar Holidays.
+
+        # Ashura.
+        for dt in self._add_ashura_day(tr("Muharram")):
+            self._move_holiday(dt)
+
+        # Eid al-Fitr.
+        for dt in self._add_eid_al_fitr_day(tr("Id-Ul-Fitr (Ramadan Eid)")):
+            self._move_holiday(dt)
+
+        # Eid al-Adha.
+        for dt in self._add_eid_al_adha_day(tr("Bakri Id")):
+            self._move_holiday(dt)
+
+
+class XNSE(NationalStockExchangeOfIndia):
+    pass
+
+
+class NSE(NationalStockExchangeOfIndia):
+    pass
+
+
+class NationalStockExchangeOfIndiaHinduHolidays(_CustomHinduHolidays):
+    HOLI_DATES = {
+        2023: (MAR, 7),
+    }
+
+
+class NationalStockExchangeOfIndiaIslamicHolidays(_CustomIslamicHolidays):
+    ASHURA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    ASHURA_DATES = {
+        2022: (AUG, 9),
+        2023: (JUL, 29),
+        2024: (JUL, 17),
+        2025: (JUL, 6),
+    }
+
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_ADHA_DATES = {
+        2022: (JUL, 10),
+        2024: (JUN, 17),
+        2025: (JUN, 7),
+    }
+
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_FITR_DATES = {
+        2022: (MAY, 3),
+        2023: (APR, 22),
+        2024: (APR, 11),
+        2025: (MAR, 31),
+    }

holidays/groups/chinese.py

@@ -14,7 +14,7 @@ from datetime import date
 from typing import Optional
 
 from holidays.calendars.chinese import _ChineseLunisolar, CHINESE_CALENDAR
-from holidays.calendars.gregorian import APR, DEC
+from holidays.calendars.gregorian import APR
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -79,20 +79,8 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
     def _dongzhi_festival(self):
         """
         Return Dongzhi Festival (Chinese Winter Solstice) date.
-
-        This approximation is reliable for 1952-2099 years.
-        """
-        #
-        if (
-            (self._year % 4 == 0 and self._year >= 1988)
-            or (self._year % 4 == 1 and self._year >= 2021)
-            or (self._year % 4 == 2 and self._year >= 2058)
-            or (self._year % 4 == 3 and self._year >= 2091)
-        ):
-            day = 21
-        else:
-            day = 22
-        return date(self._year, DEC, day)
+        """
+        return self._chinese_calendar.winter_solstice_date(self._year)[0]
 
     def _add_chinese_calendar_holiday(
         self, name: str, dt_estimated: tuple[Optional[date], bool], days_delta: int = 0

holidays/groups/eastern.py

@@ -33,15 +33,13 @@ class EasternCalendarHolidays:
 
         Adds customizable estimation label to holiday name if holiday date is an estimation.
         """
-        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
         dt, is_estimated = dt_estimated
-
         if days_delta and dt:
             dt = _timedelta(dt, days_delta)
 
         return (
             self._add_holiday(
-                self.tr(estimated_label) % self.tr(name)
+                self.tr(self.estimated_label) % self.tr(name)
                 if is_estimated and show_estimated
                 else name,
                 dt,

holidays/groups/islamic.py

@@ -182,6 +182,16 @@ class IslamicHolidays(EasternCalendarHolidays):
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+2
         )
 
+    def _add_eid_al_fitr_day_four(self, name) -> set[date]:
+        """
+        Add Eid al-Fitr Day Four.
+
+        https://en.wikipedia.org/wiki/Eid_al-Fitr
+        """
+        return self._add_islamic_calendar_holiday(
+            name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+3
+        )
+
     def _add_eid_al_fitr_eve(self, name) -> set[date]:
         """
         Add Eid al-Fitr Eve (last day of 9th month of Islamic calendar).

holidays/observed_holiday_base.py

@@ -177,7 +177,7 @@ class ObservedHolidayBase(HolidayBase):
                 )
             )
 
-            estimated_label_text = estimated_label.strip("%s ()")
+            estimated_label_text = estimated_label.strip("%s ()（）")
             # Use observed_estimated_label instead of observed_label for estimated dates.
             for name in (name,) if name else self.get_list(dt):
                 holiday_name = self.tr(name)