holidays 0.82__py3-none-any.whl → 0.83__py3-none-any.whl

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/countries/__init__.py

@@ -293,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/azerbaijan.py

@@ -172,7 +172,7 @@ class Azerbaijan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, St
                     continue
                 for holiday_name in dt_holidays:
                     if any(bayrami_name in holiday_name for bayrami_name in bayrami_names):
-                        self._add_observed(dt_observed, holiday_name, WORKDAY_TO_NEXT_WORKDAY)
+                        self._add_observed(dt_observed, holiday_name, rule=WORKDAY_TO_NEXT_WORKDAY)
 
     def _populate_workday_holidays(self):
         if self._year >= 2021:

holidays/countries/canada.py

@@ -12,9 +12,8 @@
 
 from datetime import date
 from gettext import gettext as tr
-from typing import Optional
 
-from holidays.calendars.gregorian import MAR, APR, JUN, JUL, SEP
+from holidays.calendars.gregorian import APR, SEP
 from holidays.constants import GOVERNMENT, OPTIONAL, PUBLIC
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
 from holidays.observed_holiday_base import (
@@ -101,9 +100,6 @@ class Canada(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
-    def _get_nearest_monday(self, *args) -> Optional[date]:
-        return self._get_observed_date(date(self._year, *args), rule=ALL_TO_NEAREST_MON)
-
     def _add_statutory_holidays(self):
         """Nationwide statutory holidays."""
 
@@ -336,24 +332,42 @@ class Canada(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
 
     def _populate_subdiv_nl_optional_holidays(self):
         if self._year >= 1900:
-            # Saint Patrick's Day.
-            self._add_holiday(tr("Saint Patrick's Day"), self._get_nearest_monday(MAR, 17))
+            self._move_holiday_forced(
+                # Saint Patrick's Day.
+                self._add_saint_patricks_day(tr("Saint Patrick's Day")),
+                rule=ALL_TO_NEAREST_MON,
+            )
 
         if self._year >= 1990:
             # Nearest Monday to April 23
             # 4/26 is the Monday closer to 4/23 in 2010
             # but the holiday was observed on 4/19? Crazy Newfies!
-            dt = date(2010, APR, 19) if self._year == 2010 else self._get_nearest_monday(APR, 23)
+
             # Saint George's Day.
-            self._add_holiday(tr("Saint George's Day"), dt)
+            name = tr("Saint George's Day")
+
+            if self._year == 2010:
+                self._add_holiday_apr_19(name)
+            else:
+                # Prevents overlap with Good Friday.
+                self._add_holiday(
+                    name,
+                    self._get_observed_date(date(self._year, APR, 23), rule=ALL_TO_NEAREST_MON),
+                )
 
         if self._year >= 1997:
-            # Discovery Day.
-            self._add_holiday(tr("Discovery Day"), self._get_nearest_monday(JUN, 24))
+            self._move_holiday_forced(
+                # Discovery Day.
+                self._add_holiday_jun_24(tr("Discovery Day")),
+                rule=ALL_TO_NEAREST_MON,
+            )
 
         if self._year >= 1900:
-            # Orangemen's Day.
-            self._add_holiday(tr("Orangemen's Day"), self._get_nearest_monday(JUL, 12))
+            self._move_holiday_forced(
+                # Orangemen's Day.
+                self._add_holiday_jul_12(tr("Orangemen's Day")),
+                rule=ALL_TO_NEAREST_MON,
+            )
 
         self._add_thanksgiving_day()
 

holidays/countries/denmark.py

@@ -22,14 +22,21 @@ class Denmark(HolidayBase, ChristianHolidays, InternationalHolidays):
 
     References:
         * <https://en.wikipedia.org/wiki/Public_holidays_in_Denmark>
+        * <https://da.wikipedia.org/wiki/Danske_helligdage>
+        * <https://da.wikipedia.org/wiki/Helligdagsreformen_af_1770>
         * <https://web.archive.org/web/20250422010005/https://www.norden.org/en/info-norden/public-holidays-denmark>
         * <https://web.archive.org/web/20231219155820/http://www.ft.dk/samling/20222/lovforslag/l13/index.htm>
+        * <https://web.archive.org/web/20250119084025/https://www.retsinformation.dk/eli/lta/2023/214>
+        * <https://web.archive.org/web/20251016080453/https://cphpost.dk/2025-05-01/life-in-denmark/what-happens-on-the-1st-of-may/>
+        * <https://web.archive.org/web/20140202200655/https://bibliotek.kk.dk/biblioteker/blog/grundlovsdag-dens-traditioner>
     """
 
     country = "DK"
     default_language = "da"
+    # The Helligdagsreformen af 1770 was in effect from October 16th, 1770 onwards.
+    start_year = 1771
     supported_categories = (OPTIONAL, PUBLIC)
-    supported_languages = ("da", "en_US", "uk")
+    supported_languages = ("da", "en_US", "th", "uk")
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -52,6 +59,7 @@ class Denmark(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Easter Monday.
         self._add_easter_monday(tr("Anden påskedag"))
 
+        # Removed via Act no. 214 of 06/03/2023, in effect January 1st, 2024.
         if self._year <= 2023:
             # Great Day of Prayers.
             self._add_holiday_26_days_past_easter(tr("Store bededag"))
@@ -72,11 +80,15 @@ class Denmark(HolidayBase, ChristianHolidays, InternationalHolidays):
         self._add_christmas_day_two(tr("Anden juledag"))
 
     def _populate_optional_holidays(self):
-        # Workers' Day.
-        self._add_labor_day(tr("Arbejdernes kampdag"))
-
-        # Constitution Day.
-        self._add_holiday_jun_5(tr("Grundlovsdag"))
+        # First observance in 1890.
+        if self._year >= 1890:
+            # Workers' Day.
+            self._add_labor_day(tr("Arbejdernes kampdag"))
+
+        # Gained its statutory day-off status in 1891.
+        if self._year >= 1891:
+            # Constitution Day.
+            self._add_holiday_jun_5(tr("Grundlovsdag"))
 
         # Christmas Eve.
         self._add_christmas_eve(tr("Juleaftensdag"))

holidays/countries/fiji.py

@@ -108,11 +108,10 @@ class Fiji(
             self._add_observed(self._add_holiday_sep_7("Constitution Day"))
 
         if self._year >= 2023:
-            # Girmit Day.
-            self._move_holiday(
+            self._move_holiday_forced(
+                # Girmit Day.
                 self._add_holiday_may_14("Girmit Day"),
                 rule=ALL_TO_NEAREST_MON,
-                show_observed_label=False,
             )
 
         # Ratu Sir Lala Sukuna Day.

holidays/countries/finland.py

@@ -215,14 +215,13 @@ class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Become a Flag Day in 1952.
         # Also considered the "Day of Finnish Heritage" from 1978 onward.
         if self._year >= 1952:
-            name = (
+            self._add_holiday_may_12(
                 # J. V. Snellman Day, Day of Finnish Heritage.
                 tr("J.V. Snellmanin päivä, suomalaisuuden päivä")
                 if self._year >= 1978
                 # J. V. Snellman Day.
                 else tr("J.V. Snellmanin päivä")
             )
-            self._add_holiday_may_12(name)
 
         # Become a Flag Day in 1977.
         if self._year >= 1977:
@@ -248,14 +247,13 @@ class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Become a Flag Day in 1950.
         # Also considered the "Day of Finnish Literature" from 1978 onward.
         if self._year >= 1950:
-            name = (
+            self._add_holiday_oct_10(
                 # Aleksis Kivi Day, Day of Finnish Literature.
                 tr("Aleksis Kiven päivä, suomalaisen kirjallisuuden päivä")
                 if self._year >= 1978
                 # Aleksis Kivi Day.
                 else tr("Aleksis Kiven päivä")
             )
-            self._add_holiday_oct_10(name)
 
         # Become a Flag Day in 1987.
         if self._year >= 1987:
@@ -310,14 +308,13 @@ class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Become a Flag Day in 1942.
         # Got its current name in 1950.
         if self._year >= 1942:
-            name = (
+            self._add_holiday_jun_6(
                 # Flag Day of the Finnish Defense Forces.
                 tr("Puolustusvoimain lippujuhlan päivä")
                 if self._year >= 1950
                 # Birthday of the Marshal of Finland.
                 else tr("Suomen marsalkan syntymäpäivä")
             )
-            self._add_holiday_jun_6(name)
 
         # Day of the Finnish Flag was first created in 1934.
         # This coincides with Midsummer Day.

holidays/countries/guyana.py

@@ -82,12 +82,18 @@ class Guyana(
             islamic_show_estimated:
                 Whether to add "estimated" label to Islamic holidays name
                 if holiday date is estimated.
+
+        In Guyana, the dates of the Islamic calendar usually fall a day later than
+        the corresponding dates in the Umm al-Qura calendar.
         """
         ChristianHolidays.__init__(self)
         HinduCalendarHolidays.__init__(self, cls=GuyanaHinduHolidays)
         InternationalHolidays.__init__(self)
         IslamicHolidays.__init__(
-            self, cls=GuyanaIslamicHolidays, show_estimated=islamic_show_estimated
+            self,
+            cls=GuyanaIslamicHolidays,
+            show_estimated=islamic_show_estimated,
+            calendar_delta_days=+1,
         )
         StaticHolidays.__init__(self, cls=GuyanaStaticHolidays)
         kwargs.setdefault("observed_rule", SUN_TO_NEXT_MON)
@@ -210,44 +216,30 @@ class GuyanaIslamicHolidays(_CustomIslamicHolidays):
     # https://web.archive.org/web/20250424074512/https://www.timeanddate.com/holidays/guyana/eid-al-adha
     EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2001, 2025)
     EID_AL_ADHA_DATES = {
-        2001: (MAR, 6),
-        2002: (FEB, 23),
-        2003: (FEB, 12),
-        2004: (FEB, 2),
-        2008: (DEC, 9),
-        2009: (NOV, 28),
-        2010: (NOV, 17),
-        2011: (NOV, 7),
-        2014: (OCT, 5),
-        2015: (SEP, 24),
+        2005: (JAN, 21),
+        2006: ((JAN, 10), (DEC, 31)),
+        2007: (DEC, 20),
+        2012: (OCT, 26),
+        2013: (OCT, 15),
         2016: (SEP, 13),
-        2017: (SEP, 2),
-        2018: (AUG, 22),
-        2021: (JUL, 21),
-        2023: (JUN, 29),
-        2024: (JUN, 17),
-        2025: (JUN, 7),
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2022: (JUL, 9),
     }
 
     # https://web.archive.org/web/20241006104125/https://www.timeanddate.com/holidays/guyana/prophet-birthday
     MAWLID_DATES_CONFIRMED_YEARS = (2001, 2025)
     MAWLID_DATES = {
-        2003: (MAY, 14),
-        2004: (MAY, 2),
-        2006: (APR, 11),
-        2011: (FEB, 16),
-        2012: (FEB, 5),
-        2014: (JAN, 14),
+        2001: (JUN, 4),
+        2002: (MAY, 24),
+        2005: (APR, 21),
+        2007: (MAR, 31),
+        2008: (MAR, 20),
+        2009: (MAR, 9),
+        2010: (FEB, 26),
+        2013: (JAN, 24),
         2015: ((JAN, 3), (DEC, 24)),
-        2016: (DEC, 12),
-        2017: (DEC, 1),
-        2018: (NOV, 21),
-        2019: (NOV, 10),
-        2021: (OCT, 19),
-        2022: (OCT, 9),
-        2023: (SEP, 28),
-        2024: (SEP, 16),
-        2025: (SEP, 5),
+        2020: (OCT, 29),
     }
 
 

holidays/countries/india.py

@@ -14,7 +14,7 @@ import warnings
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, AUG, SEP, OCT, NOV, DEC
 from holidays.constants import OPTIONAL, PUBLIC
 from holidays.groups import (
     ChristianHolidays,
@@ -156,11 +156,17 @@ class India(
             islamic_show_estimated:
                 Whether to add "estimated" label to Islamic holidays name
                 if holiday date is estimated.
+
+        In India, the dates of the Islamic calendar usually fall a day later than
+        the corresponding dates in the Umm al-Qura calendar.
         """
         ChristianHolidays.__init__(self)
         HinduCalendarHolidays.__init__(self)
         IslamicHolidays.__init__(
-            self, cls=IndiaIslamicHolidays, show_estimated=islamic_show_estimated
+            self,
+            cls=IndiaIslamicHolidays,
+            show_estimated=islamic_show_estimated,
+            calendar_delta_days=+1,
         )
         InternationalHolidays.__init__(self)
         super().__init__(*args, **kwargs)
@@ -518,103 +524,40 @@ class IND(India):
 class IndiaIslamicHolidays(_CustomIslamicHolidays):
     ASHURA_DATES_CONFIRMED_YEARS = (2001, 2025)
     ASHURA_DATES = {
-        2003: (MAR, 14),
-        2004: (MAR, 2),
-        2007: (JAN, 30),
+        2001: (APR, 4),
+        2002: (MAR, 24),
+        2005: (FEB, 19),
+        2006: (FEB, 9),
+        2008: (JAN, 19),
         2009: ((JAN, 7), (DEC, 28)),
-        2010: (DEC, 17),
-        2011: (DEC, 6),
-        2012: (NOV, 25),
-        2013: (NOV, 14),
-        2014: (NOV, 4),
-        2015: (OCT, 24),
-        2016: (OCT, 12),
-        2017: (OCT, 1),
-        2018: (SEP, 21),
-        2019: (SEP, 10),
-        2020: (AUG, 30),
         2021: (AUG, 20),
-        2022: (AUG, 9),
-        2023: (JUL, 29),
-        2024: (JUL, 17),
-        2025: (JUL, 6),
     }
 
     EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2001, 2025)
     EID_AL_ADHA_DATES = {
-        2001: (MAR, 6),
-        2002: (FEB, 23),
-        2003: (FEB, 12),
-        2004: (FEB, 2),
+        2005: (JAN, 21),
         2006: ((JAN, 11), (DEC, 31)),
-        2008: (DEC, 9),
-        2009: (NOV, 28),
-        2010: (NOV, 17),
-        2011: (NOV, 7),
-        2012: (OCT, 27),
-        2013: (OCT, 16),
+        2007: (DEC, 20),
         2014: (OCT, 6),
         2015: (SEP, 25),
         2016: (SEP, 13),
-        2017: (SEP, 2),
-        2018: (AUG, 22),
-        2019: (AUG, 12),
-        2020: (AUG, 1),
-        2021: (JUL, 21),
-        2022: (JUL, 10),
-        2023: (JUN, 29),
-        2024: (JUN, 17),
-        2025: (JUN, 7),
     }
 
     EID_AL_FITR_DATES_CONFIRMED_YEARS = (2001, 2025)
     EID_AL_FITR_DATES = {
-        2001: (DEC, 17),
-        2002: (DEC, 6),
-        2003: (NOV, 26),
-        2006: (OCT, 24),
-        2008: (OCT, 2),
-        2009: (SEP, 21),
-        2011: (AUG, 31),
-        2012: (AUG, 20),
-        2014: (JUL, 29),
-        2015: (JUL, 18),
-        2016: (JUL, 7),
-        2017: (JUN, 26),
-        2018: (JUN, 16),
-        2019: (JUN, 5),
-        2020: (MAY, 25),
-        2021: (MAY, 14),
-        2022: (MAY, 3),
-        2023: (APR, 22),
-        2024: (APR, 11),
-        2025: (MAR, 31),
+        2004: (NOV, 14),
+        2005: (NOV, 3),
+        2007: (OCT, 13),
+        2010: (SEP, 10),
+        2013: (AUG, 8),
     }
 
     MAWLID_DATES_CONFIRMED_YEARS = (2001, 2025)
     MAWLID_DATES = {
-        2001: (JUN, 5),
-        2002: (MAY, 25),
         2003: (MAY, 15),
         2004: (MAY, 3),
-        2005: (APR, 22),
-        2006: (APR, 11),
-        2007: (APR, 1),
-        2008: (MAR, 21),
-        2010: (FEB, 27),
-        2011: (FEB, 16),
-        2012: (FEB, 5),
-        2013: (JAN, 25),
-        2014: (JAN, 14),
+        2009: (MAR, 9),
         2015: ((JAN, 4), (DEC, 25)),
         2016: (DEC, 13),
         2017: (DEC, 2),
-        2018: (NOV, 21),
-        2019: (NOV, 10),
-        2020: (OCT, 30),
-        2021: (OCT, 19),
-        2022: (OCT, 9),
-        2023: (SEP, 28),
-        2024: (SEP, 16),
-        2025: (SEP, 5),
     }