holidays 0.48__py3-none-any.whl → 0.49__py3-none-any.whl

holidays/__init__.py

@@ -17,7 +17,7 @@ from holidays.holiday_base import *
 from holidays.registry import EntityLoader
 from holidays.utils import *
 
-__version__ = "0.48"
+__version__ = "0.49"
 
 
 EntityLoader.load("countries", globals())

holidays/calendars/gregorian.py

@@ -11,7 +11,6 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from datetime import timedelta as td
 
 GREGORIAN_CALENDAR = "GREGORIAN_CALENDAR"
 
@@ -30,6 +29,19 @@ MONTHS = {
 WEEKDAYS = {w: i for i, w in enumerate(("mon", "tue", "wed", "thu", "fri", "sat", "sun"))}
 
 
+# Holiday names.
+CHRISTMAS = "christmas"
+WINTER_SOLSTICE = "winter_solstice"
+
+
+def _timedelta(dt: date, days: int = 0) -> date:
+    """
+    Return date that is `days` days after (days > 0) or before (days < 0) specified date.
+    """
+
+    return date.fromordinal(dt.toordinal() + days)
+
+
 def _get_nth_weekday_from(n: int, weekday: int, from_dt: date) -> date:
     """
     Return date of a n-th weekday before a specific date
@@ -39,10 +51,13 @@ def _get_nth_weekday_from(n: int, weekday: int, from_dt: date) -> date:
     Examples: 1st Monday, 2nd Saturday, etc).
     """
 
-    return from_dt + td(
-        days=(n - 1) * 7 + (weekday - from_dt.weekday()) % 7
-        if n > 0
-        else (n + 1) * 7 - (from_dt.weekday() - weekday) % 7
+    return _timedelta(
+        from_dt,
+        (
+            (n - 1) * 7 + (weekday - from_dt.weekday()) % 7
+            if n > 0
+            else (n + 1) * 7 - (from_dt.weekday() - weekday) % 7
+        ),
     )
 
 
@@ -61,7 +76,7 @@ def _get_nth_weekday_of_month(n: int, weekday: int, month: int, year: int) -> da
         if month > 12:
             month = 1
             year += 1
-        start_date = date(year, month, 1) + td(days=-1)
+        start_date = _timedelta(date(year, month, 1), -1)
     else:
         start_date = date(year, month, 1)
 
@@ -77,4 +92,4 @@ def _get_nth_weekday_of_month(n: int, weekday: int, month: int, year: int) -> da
 def _get_all_sundays(year):
     first_sunday = _get_nth_weekday_of_month(1, SUN, JAN, year)
     for n in range(0, (date(year, DEC, 31) - first_sunday).days + 1, 7):
-        yield first_sunday + td(days=n)
+        yield _timedelta(first_sunday, n)

holidays/calendars/persian.py

@@ -11,9 +11,10 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from datetime import timedelta as td
 from typing import Optional
 
+from holidays.calendars.gregorian import _timedelta
+
 
 class _Persian:
     """
@@ -54,4 +55,4 @@ class _Persian:
 
         m = j_month - 1
         delta = (31 * m if m < 6 else 186 + 30 * (m - 6)) + j_day - 1
-        return start_date + td(days=delta)
+        return _timedelta(start_date, delta)

holidays/calendars/thai.py

@@ -11,10 +11,11 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from datetime import timedelta as td
 from functools import lru_cache
 from typing import Optional
 
+from holidays.calendars.gregorian import _timedelta
+
 KHMER_CALENDAR = "KHMER_CALENDAR"
 THAI_CALENDAR = "THAI_CALENDAR"
 
@@ -230,7 +231,7 @@ class _ThaiLunisolar:
             elif iter_year in _ThaiLunisolar.ATHIKAWAN_YEARS_GREGORIAN:
                 delta_days += 1
 
-        return _ThaiLunisolar.START_DATE + td(days=delta_days)
+        return _timedelta(_ThaiLunisolar.START_DATE, delta_days)
 
     def makha_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """
@@ -267,13 +268,14 @@ class _ThaiLunisolar:
         if not start_date:
             return None
 
-        return start_date + td(
-            days=+102
+        return _timedelta(
+            start_date,
+            +102
             if (
                 year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN
                 and not self.__is_khmer_calendar(calendar)
             )
-            else +73
+            else +73,
         )
 
     def visakha_bucha_date(self, year: int, calendar=None) -> Optional[date]:
@@ -310,13 +312,14 @@ class _ThaiLunisolar:
         if not start_date:
             return None
 
-        return start_date + td(
-            days=+191
+        return _timedelta(
+            start_date,
+            +191
             if (
                 year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN
                 and not self.__is_khmer_calendar(calendar)
             )
-            else +161
+            else +161,
         )
 
     def preah_neangkoal_date(self, year: int) -> Optional[date]:
@@ -346,7 +349,7 @@ class _ThaiLunisolar:
         if not start_date:
             return None
 
-        return start_date + td(days=+165)
+        return _timedelta(start_date, +165)
 
     def atthami_bucha_date(self, year: int, calendar=None) -> Optional[date]:
         """
@@ -383,13 +386,14 @@ class _ThaiLunisolar:
         if not start_date:
             return None
 
-        return start_date + td(
-            days=+199
+        return _timedelta(
+            start_date,
+            +199
             if (
                 year in _ThaiLunisolar.ATHIKAMAT_YEARS_GREGORIAN
                 and not self.__is_khmer_calendar(calendar)
             )
-            else +169
+            else +169,
         )
 
     def asarnha_bucha_date(self, year: int) -> Optional[date]:
@@ -430,7 +434,7 @@ class _ThaiLunisolar:
             delta_days = +221
         else:
             delta_days = +220
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def khao_phansa_date(self, year: int) -> Optional[date]:
         """
@@ -469,7 +473,7 @@ class _ThaiLunisolar:
             delta_days = +222
         else:
             delta_days = +221
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def boun_haw_khao_padapdin_date(self, year: int) -> Optional[date]:
         """
@@ -503,7 +507,7 @@ class _ThaiLunisolar:
             delta_days = +265
         else:
             delta_days = +264
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def boun_haw_khao_salark_date(self, year: int) -> Optional[date]:
         """
@@ -537,7 +541,7 @@ class _ThaiLunisolar:
             delta_days = +280
         else:
             delta_days = +279
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def pchum_ben_date(self, year: int) -> Optional[date]:
         """
@@ -571,7 +575,7 @@ class _ThaiLunisolar:
             delta_days = +295
         else:
             delta_days = +294
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def ok_phansa_date(self, year: int) -> Optional[date]:
         """
@@ -605,7 +609,7 @@ class _ThaiLunisolar:
             delta_days = +310
         else:
             delta_days = +309
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def boun_suang_heua_date(self, year: int) -> Optional[date]:
         """
@@ -639,7 +643,7 @@ class _ThaiLunisolar:
             delta_days = +311
         else:
             delta_days = +310
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)
 
     def loy_krathong_date(self, year: int) -> Optional[date]:
         """
@@ -673,4 +677,4 @@ class _ThaiLunisolar:
             delta_days = +339
         else:
             delta_days = +338
-        return start_date + td(days=delta_days)
+        return _timedelta(start_date, delta_days)

holidays/countries/angola.py

@@ -12,7 +12,7 @@
 
 from datetime import date
 from gettext import gettext as tr
-from typing import Tuple
+from typing import Optional, Tuple
 
 from holidays.calendars.gregorian import AUG, SEP
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
@@ -59,7 +59,7 @@ class Angola(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         # it rolls over to the following Monday.
         return dt >= date(1996, SEP, 27)
 
-    def _add_observed(self, dt: date, **kwargs) -> Tuple[bool, date]:
+    def _add_observed(self, dt: date, **kwargs) -> Tuple[bool, Optional[date]]:
         # As per Law # #11/18, from 2018/9/10, when public holiday falls on Tuesday or Thursday,
         # the Monday or Friday is also a holiday.
         kwargs.setdefault(

holidays/countries/aruba.py

@@ -11,10 +11,9 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from datetime import timedelta as td
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import APR, AUG
+from holidays.calendars.gregorian import APR, AUG, _timedelta
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -118,7 +117,7 @@ class Aruba(HolidayBase, ChristianHolidays, InternationalHolidays):
         else:
             dt = (AUG, 31)
         if self._is_sunday(dt):
-            dt = date(self._year, *dt) + td(days=-1 if self._year >= 1980 else +1)
+            dt = _timedelta(date(self._year, *dt), -1 if self._year >= 1980 else +1)
         self._add_holiday(name, dt)
 
         # Dia di Labor/Dia di Obrero.

holidays/countries/cambodia.py

@@ -10,10 +10,9 @@
 #  Website: https://github.com/vacanza/python-holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import timedelta as td
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import MAY, AUG, SEP
+from holidays.calendars.gregorian import MAY, AUG, SEP, _timedelta
 from holidays.calendars.thai import KHMER_CALENDAR
 from holidays.groups import InternationalHolidays, StaticHolidays, ThaiCalendarHolidays
 from holidays.holiday_base import HolidayBase
@@ -98,8 +97,8 @@ class Cambodia(HolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarH
                 if self._year in sangkranta_years_apr_14
                 else self._add_holiday_apr_13(sangkranta)
             )
-            self._add_holiday(sangkranta, dt + td(days=+1))
-            self._add_holiday(sangkranta, dt + td(days=+2))
+            self._add_holiday(sangkranta, _timedelta(dt, +1))
+            self._add_holiday(sangkranta, _timedelta(dt, +2))
 
         #  ទិវាពលកម្មអន្តរជាតិ
         # Status: In-Use.
@@ -253,9 +252,9 @@ class Cambodia(HolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarH
         pchum_ben = tr("ពិធីបុណ្យភ្ផុំបិណ្ឌ")
         pchum_ben_date = self._add_pchum_ben(pchum_ben)
         if pchum_ben_date:
-            self._add_holiday(pchum_ben, pchum_ben_date + td(days=-1))
+            self._add_holiday(pchum_ben, _timedelta(pchum_ben_date, -1))
             if self._year >= 2017:
-                self._add_holiday(pchum_ben, pchum_ben_date + td(days=+1))
+                self._add_holiday(pchum_ben, _timedelta(pchum_ben_date, +1))
 
         # ព្រះរាជពិធីបុណ្យអុំទូក បណ្តែតប្រទីប និងសំពះព្រះខែអកអំបុក
         # Status: In-Use.
@@ -265,8 +264,8 @@ class Cambodia(HolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarH
         bon_om_touk = tr("ព្រះរាជពិធីបុណ្យអុំទូក បណ្តែតប្រទីប និងសំពះព្រះខែអកអំបុក")
         bon_om_touk_date = self._add_loy_krathong(bon_om_touk)
         if bon_om_touk_date:
-            self._add_holiday(bon_om_touk, bon_om_touk_date + td(days=-1))
-            self._add_holiday(bon_om_touk, bon_om_touk_date + td(days=+1))
+            self._add_holiday(bon_om_touk, _timedelta(bon_om_touk_date, -1))
+            self._add_holiday(bon_om_touk, _timedelta(bon_om_touk_date, +1))
 
 
 class KH(Cambodia):

holidays/countries/canada.py

@@ -12,6 +12,7 @@
 
 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.constants import GOVERNMENT, OPTIONAL, PUBLIC
@@ -69,7 +70,7 @@ 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) -> date:
+    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):

holidays/countries/curacao.py

@@ -11,10 +11,9 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from datetime import timedelta as td
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import APR, MAY
+from holidays.calendars.gregorian import APR, MAY, _timedelta
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -90,7 +89,7 @@ class Curacao(HolidayBase, ChristianHolidays, InternationalHolidays):
         )
         dt = date(self._year, APR, 27 if self._year >= 2014 else 30)
         if self._is_sunday(dt):
-            dt += td(days=-1 if self._year >= 1980 else +1)
+            dt = _timedelta(dt, -1 if self._year >= 1980 else +1)
         self._add_holiday(name, dt)
 
         # Dia di Obrero.
@@ -99,7 +98,7 @@ class Curacao(HolidayBase, ChristianHolidays, InternationalHolidays):
 
         dt = date(self._year, MAY, 1)
         if self._is_sunday(dt) or (self._is_monday(dt) and self._year <= 1979):
-            dt += td(days=+1)
+            dt = _timedelta(dt, +1)
         # Labor Day
         self._add_holiday(tr("Dia di Obrero"), dt)
 

holidays/countries/finland.py

@@ -10,9 +10,9 @@
 #  Website: https://github.com/vacanza/python-holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import timedelta as td
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import _timedelta
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -72,7 +72,7 @@ class Finland(HolidayBase, ChristianHolidays, InternationalHolidays):
             dt = self._add_holiday_jun_23(name)
 
         # Midsummer Day.
-        self._add_holiday(tr("Juhannuspäivä"), dt + td(days=+1))
+        self._add_holiday(tr("Juhannuspäivä"), _timedelta(dt, +1))
 
         # All Saints' Day.
         name = tr("Pyhäinpäivä")