holidays 0.63__py3-none-any.whl → 0.65__py3-none-any.whl

holidays/calendars/hebrew.py

@@ -1598,7 +1598,36 @@ class _HebrewLunisolar:
         2100: (OCT, 13),
     }
 
-    @staticmethod
-    def _get_holiday(holiday: str, year: int) -> Optional[date]:
-        dt = getattr(_HebrewLunisolar, f"{holiday}_DATES", {}).get(year, ())
+    def _get_holiday(self, holiday: str, year: int) -> Optional[date]:
+        dt = getattr(self, f"{holiday}_DATES", {}).get(year, ())
         return date(year, *dt) if dt else None
+
+    def hanukkah_date(self, year: int) -> set[Optional[date]]:
+        return {self._get_holiday(HANUKKAH, y) for y in (year - 1, year)}
+
+    def israel_independence_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(INDEPENDENCE_DAY, year)
+
+    def lag_baomer_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(LAG_BAOMER, year)
+
+    def passover_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(PASSOVER, year)
+
+    def purim_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(PURIM, year)
+
+    def rosh_hashanah_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(ROSH_HASHANAH, year)
+
+    def shavuot_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(SHAVUOT, year)
+
+    def sukkot_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(SUKKOT, year)
+
+    def tisha_bav_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(TISHA_BAV, year)
+
+    def yom_kippur_date(self, year: int) -> Optional[date]:
+        return self._get_holiday(YOM_KIPPUR, year)

holidays/constants.py

@@ -54,6 +54,7 @@ CHRISTIAN = "christian"
 HEBREW = "hebrew"
 HINDU = "hindu"
 ISLAMIC = "islamic"
+ORTHODOX = "orthodox"
 
 DEFAULT_START_YEAR = 1901
 DEFAULT_END_YEAR = 2100

holidays/countries/__init__.py

@@ -12,6 +12,7 @@
 
 # flake8: noqa: F401
 
+from .afghanistan import Afghanistan, AF, AFG
 from .albania import Albania, AL, ALB
 from .algeria import Algeria, DZ, DZA
 from .american_samoa import AmericanSamoa, AS, ASM, HolidaysAS

holidays/countries/afghanistan.py

@@ -0,0 +1,192 @@
+#  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 AUTHORS 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 _CustomIslamicHolidays
+from holidays.calendars.gregorian import (
+    JAN,
+    MAR,
+    APR,
+    MAY,
+    JUN,
+    JUL,
+    AUG,
+    SEP,
+    OCT,
+    NOV,
+    DEC,
+    FRI,
+    SAT,
+)
+from holidays.groups import InternationalHolidays, IslamicHolidays, PersianCalendarHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Afghanistan(HolidayBase, InternationalHolidays, IslamicHolidays, PersianCalendarHolidays):
+    """
+    https://en.wikipedia.org/wiki/Public_holidays_in_Afghanistan
+    https://www.timeanddate.com/holidays/afghanistan/
+    https://en.wikipedia.org/wiki/Workweek_and_weekend
+    """
+
+    country = "AF"
+    default_language = "fa_AF"
+    # %s (estimated).
+    estimated_label = tr("%s (برآورد شده)")
+    supported_languages = ("en_US", "fa_AF", "ps_AF")
+    # Afghanistan's regaining of full independence from British influence.
+    start_year = 1919
+    weekend = {FRI, SAT}
+
+    def __init__(self, *args, **kwargs):
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(self, AfghanistanIslamicHolidays)
+        PersianCalendarHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        if self._year >= 1989:
+            # Liberation Day.
+            self._add_holiday_feb_15(tr("روز آزادی"))
+
+        # Afghanistan Independence Day.
+        self._add_holiday_aug_19(tr("روز استقلال افغانستان"))
+
+        if self._year <= 1996 or 2001 <= self._year <= 2020:
+            # Nowruz.
+            self._add_nowruz_day(tr("نوروز"))
+
+        if self._year >= 1992:
+            # Mojahedin's Victory Day.
+            self._add_holiday_apr_28(tr("روز پیروزی مجاهدین"))
+
+        if 1974 <= self._year <= 1996 or 2002 <= self._year <= 2021:
+            # International Workers' Day.
+            self._add_labor_day(tr("روز جهانی کارگر"))
+
+        if 1978 <= self._year <= 1988:
+            # Soviet Victory Day.
+            self._add_holiday_may_9(tr("روز پیروزی شوروی"))
+
+        if self._year >= 2022:
+            # Islamic Emirate Victory Day.
+            self._add_islamic_emirat_victory_day(tr("روز پیروزی امارت اسلامی"))
+
+            # American Withdrawal Day.
+            self._add_holiday_aug_31(tr("روز خروج آمریکایی ها"))
+
+        if 2012 <= self._year <= 2020:
+            # Martyrs' Day.
+            self._add_holiday_sep_9(tr("روز شهیدان"))
+
+        if self._year <= 2021:
+            # Ashura.
+            self._add_ashura_day(tr("عاشورا"))
+
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("میلاد پیامبر"))
+
+        # First Day of Ramadan.
+        self._add_ramadan_beginning_day(tr("اول رمضان"))
+
+        # Eid al-Fitr.
+        name = tr("عید فطر")
+        self._add_eid_al_fitr_day(name)
+        self._add_eid_al_fitr_day_two(name)
+        self._add_eid_al_fitr_day_three(name)
+
+        # Day of Arafah.
+        self._add_arafah_day(tr("روز عرفه"))
+
+        # Eid al-Adha.
+        name = tr("عید قربانی")
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
+
+
+class AF(Afghanistan):
+    pass
+
+
+class AFG(Afghanistan):
+    pass
+
+
+class AfghanistanIslamicHolidays(_CustomIslamicHolidays):
+    ASHURA_DATES = {
+        2014: (NOV, 3),
+        2015: (OCT, 24),
+        2016: (OCT, 12),
+        2017: (OCT, 1),
+        2018: (SEP, 21),
+        2019: (SEP, 10),
+        2020: (AUG, 30),
+        2021: (AUG, 19),
+    }
+
+    EID_AL_ADHA_DATES = {
+        2014: (OCT, 5),
+        2015: (SEP, 23),
+        2016: (SEP, 13),
+        2017: (SEP, 2),
+        2018: (AUG, 22),
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+        2024: (JUN, 17),
+    }
+
+    EID_AL_FITR_DATES = {
+        2014: (JUL, 29),
+        2015: (JUL, 18),
+        2016: (JUL, 7),
+        2017: (JUN, 26),
+        2018: (JUN, 15),
+        2019: (JUN, 4),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 1),
+        2023: (APR, 22),
+        2024: (APR, 10),
+    }
+
+    MAWLID_DATES = {
+        2014: (JAN, 14),
+        2015: ((JAN, 3), (DEC, 24)),
+        2016: (DEC, 12),
+        2017: (DEC, 1),
+        2018: (NOV, 21),
+        2019: (NOV, 10),
+        2020: (OCT, 29),
+        2021: (OCT, 19),
+        2022: (OCT, 8),
+        2023: (SEP, 27),
+        2024: (SEP, 16),
+    }
+
+    RAMADAN_BEGINNING_DATES = {
+        2014: (JUN, 29),
+        2015: (JUN, 18),
+        2016: (JUN, 7),
+        2017: (MAY, 27),
+        2018: (MAY, 16),
+        2019: (MAY, 6),
+        2020: (APR, 24),
+        2021: (APR, 13),
+        2022: (APR, 2),
+        2023: (MAR, 23),
+        2024: (MAR, 11),
+    }

holidays/countries/azerbaijan.py

@@ -287,10 +287,10 @@ class AzerbaijanStaticHolidays:
         2018: (APR, 11, presidential_elections),
         2019: (DEC, 27, municipal_elections),
         2020: (
-            (MAR, 27, MAR, 29),
-            (MAY, 27, MAY, 30),
             (JAN, 3, DEC, 28, 2019),
             (JAN, 6, DEC, 29, 2019),
+            (MAR, 27, MAR, 29),
+            (MAY, 27, MAY, 30),
         ),
         2021: (
             (MAY, 11, MAY, 8),

holidays/countries/belarus.py

@@ -14,6 +14,7 @@ from gettext import gettext as tr
 
 from holidays.calendars.gregorian import GREGORIAN_CALENDAR, JAN, MAR, APR, MAY, JUN, JUL, NOV, DEC
 from holidays.calendars.julian import JULIAN_CALENDAR
+from holidays.constants import PUBLIC, WORKDAY
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -23,18 +24,24 @@ class Belarus(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
     Belarus holidays.
 
     References:
-        - http://president.gov.by/en/holidays_en/
+        - https://president.gov.by/en/gosudarstvo/prazdniki
+        - https://president.gov.by/be/gosudarstvo/prazdniki
+        - https://president.gov.by/ru/gosudarstvo/prazdniki
         - http://www.belarus.by/en/about-belarus/national-holidays
         - http://laws.newsby.org/documents/ukazp/pos05/ukaz05806.htm
         - http://president.gov.by/uploads/documents/2019/464uk.pdf
-        - https://ru.wikipedia.org/wiki/%D0%9F%D1%80%D0%B0%D0%B7%D0%B4%D0%BD%D0%B8%D0%BA%D0%B8_%D0%91%D0%B5%D0%BB%D0%BE%D1%80%D1%83%D1%81%D1%81%D0%B8%D0%B8
+        - https://ru.wikipedia.org/wiki/Праздники_Белоруссии
+
+    Cross-checked With:
+        - https://president.gov.by/en/gosudarstvo/prazdniki/calendar-2024
     """
 
     country = "BY"
     default_language = "be"
-    supported_languages = ("be", "en_US")
-    # The current set of holidays actual from 1998.
-    start_year = 1998
+    supported_categories = (PUBLIC, WORKDAY)
+    supported_languages = ("be", "en_US", "ru", "th")
+    # Declaration of State Sovereignty of the BSSR.
+    start_year = 1991
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
@@ -44,10 +51,10 @@ class Belarus(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
 
     def _populate_public_holidays(self):
         # New Year's Day.
-        self._add_new_years_day(tr("Новы год"))
-
+        name = tr("Новы год")
+        self._add_new_years_day(name)
         if self._year >= 2020:
-            self._add_new_years_day_two(tr("Новы год"))
+            self._add_new_years_day_two(name)
 
         # Orthodox Christmas Day.
         self._add_christmas_day(tr("Нараджэнне Хрыстова (праваслаўнае Раство)"))
@@ -55,8 +62,9 @@ class Belarus(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         # Women's Day.
         self._add_womens_day(tr("Дзень жанчын"))
 
-        # Radunitsa (Day of Rejoicing).
-        self._add_rejoicing_day(tr("Радаўніца"))
+        if 1995 <= self._year <= 1998:
+            # Constitution Day.
+            self._add_holiday_mar_15(tr("Дзень Канстытуцыі"))
 
         # Labor Day.
         self._add_labor_day(tr("Свята працы"))
@@ -64,15 +72,70 @@ class Belarus(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         # Victory Day.
         self._add_world_war_two_victory_day(tr("Дзень Перамогі"), is_western=False)
 
-        # Independence Day.
-        self._add_holiday_jul_3(tr("Дзень Незалежнасці Рэспублікі Беларусь (Дзень Рэспублікі)"))
+        # Radunitsa (Day of Rejoicing).
+        self._add_rejoicing_day(tr("Радаўніца"))
+
+        # Independence Day of the Republic of Belarus (Day of the Republic).
+        name = tr("Дзень Незалежнасці Рэспублікі Беларусь (Дзень Рэспублікі)")
+        if self._year >= 1997:
+            self._add_holiday_jul_3(name)
+        else:
+            self._add_holiday_jul_27(name)
 
-        # October Revolution Day.
-        self._add_holiday_nov_7(tr("Дзень Кастрычніцкай рэвалюцыі"))
+        if self._year >= 1995:
+            # October Revolution Day.
+            self._add_holiday_nov_7(tr("Дзень Кастрычніцкай рэвалюцыі"))
 
         # Catholic Christmas Day.
         self._add_christmas_day(tr("Нараджэнне Хрыстова (каталіцкае Раство)"), GREGORIAN_CALENDAR)
 
+        if self._year >= 1992:
+            # Catholic Easter.
+            name_catholic = tr("Каталiцкi Вялiкдзень")
+            self._add_easter_sunday(name_catholic, GREGORIAN_CALENDAR)
+
+            # Orthodox Easter.
+            name_orthodox = tr("Праваслаўны Вялiкдзень")
+            self._add_easter_sunday(name_orthodox)
+
+            if self._year <= 1997:
+                self._add_easter_monday(name_catholic, GREGORIAN_CALENDAR)
+                self._add_easter_monday(name_orthodox)
+
+                # Dzyady (All Souls' Day).
+                self._add_all_souls_day(tr("Дзень памяці"))
+
+    def _populate_workday_holidays(self):
+        # Day of the Fatherland's Defenders and the Armed Forces of the Republic of Belarus.
+        self._add_holiday_feb_23(tr("Дзень абаронцаў Айчыны і Узброеных Сіл Рэспублікі Беларусь"))
+
+        if self._year >= 1999:
+            # Constitution Day.
+            self._add_holiday_mar_15(tr("Дзень Канстытуцыі"))
+
+        if self._year >= 1996:
+            # Day of Unity of the Peoples of Belarus and Russia.
+            self._add_holiday_apr_2(tr("Дзень яднання народаў Беларусі і Расіі"))
+
+        if self._year >= 1998:
+            self._add_holiday_2nd_sun_of_may(
+                # Day of the National Coat of Arms of the Republic of Belarus,
+                # the National Flag of the Republic of Belarus
+                # and the National Anthem of the Republic of Belarus.
+                tr(
+                    "Дзень Дзяржаўнага сцяга, Дзяржаўнага герба і Дзяржаўнага "
+                    "гімна Рэспублікі Беларусь"
+                )
+            )
+
+        if self._year >= 2021:
+            # Day of People's Unity.
+            self._add_holiday_sep_17(tr("Дзень народнага адзінства"))
+
+        if self._year >= 1998:
+            # Dzyady (All Souls' Day).
+            self._add_all_souls_day(tr("Дзень памяці"))
+
 
 class BY(Belarus):
     pass
@@ -83,6 +146,12 @@ class BLR(Belarus):
 
 
 class BelarusStaticHolidays:
+    """
+    References
+        - https://belarusbank.by/en/financial-institutions/11151
+        - https://belarusbank.by/en/financial-institutions/11160
+    """
+
     # Date format (see strftime() Format Codes)
     substituted_date_format = tr("%d.%m.%Y")
     # Day off (substituted from %s).
@@ -221,4 +290,14 @@ class BelarusStaticHolidays:
             (MAY, 8, MAY, 13),
             (NOV, 6, NOV, 11),
         ),
+        2024: (
+            (MAY, 13, MAY, 18),
+            (NOV, 8, NOV, 16),
+        ),
+        2025: (
+            (JAN, 6, JAN, 11),
+            (APR, 28, APR, 26),
+            (JUL, 4, JUL, 12),
+            (DEC, 26, DEC, 20),
+        ),
     }

holidays/countries/el_salvador.py

@@ -10,6 +10,8 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from gettext import gettext as tr
+
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -17,12 +19,14 @@ from holidays.holiday_base import HolidayBase
 class ElSalvador(HolidayBase, ChristianHolidays, InternationalHolidays):
     """
     References:
-    - https://www.transparencia.gob.sv/institutions/gd-usulutan/documents/192280/download
-    - https://www.timeanddate.com/holidays/el-salvador
-    - https://www.officeholidays.com/countries/el-salvador
+        - `Labor Code 1972 <https://www.transparencia.gob.sv/institutions/gd-usulutan/documents/192280/download>`_
+        - https://www.timeanddate.com/holidays/el-salvador
+        - https://www.officeholidays.com/countries/el-salvador
     """
 
     country = "SV"
+    default_language = "es"
+    supported_languages = ("en_US", "es", "uk")
     subdivisions = (
         "AH",  # Ahuachapán
         "CA",  # Cabañas
@@ -39,6 +43,24 @@ class ElSalvador(HolidayBase, ChristianHolidays, InternationalHolidays):
         "UN",  # La Unión
         "US",  # Usulután
     )
+    subdivisions_aliases = {
+        "Ahuachapán": "AH",
+        "Cabañas": "CA",
+        "Chalatenango": "CH",
+        "Cuscatlán": "CU",
+        "La Libertad": "LI",
+        "Morazán": "MO",
+        "La Paz": "PA",
+        "Santa Ana": "SA",
+        "San Miguel": "SM",
+        "Sonsonate": "SO",
+        "San Salvador": "SS",
+        "San Vicente": "SV",
+        "La Unión": "UN",
+        "Usulután": "US",
+    }
+    # Labor Code 1972.
+    start_year = 1973
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -47,48 +69,47 @@ class ElSalvador(HolidayBase, ChristianHolidays, InternationalHolidays):
 
     def _populate_public_holidays(self):
         # New Year's Day.
-        self._add_new_years_day("New Year's Day")
+        self._add_new_years_day(tr("Año Nuevo"))
 
         # Maundy Thursday.
-        self._add_holy_thursday("Maundy Thursday")
+        self._add_holy_thursday(tr("Jueves Santo"))
 
         # Good Friday.
-        self._add_good_friday("Good Friday")
+        self._add_good_friday(tr("Viernes Santo"))
 
         # Holy Saturday.
-        self._add_holy_saturday("Holy Saturday")
+        self._add_holy_saturday(tr("Sábado Santo"))
 
         # Labor Day.
-        self._add_labor_day("Labor Day")
+        self._add_labor_day(tr("Día del Trabajo"))
 
+        # Legislative Decree #399 from Apr 14, 2016.
         if self._year >= 2016:
-            # Legislative Decree #399 from Apr 14, 2016
-            # Mothers' Day.
-            self._add_holiday_may_10("Mothers' Day")
+            # Mother's Day.
+            self._add_holiday_may_10(tr("Día de la Madre"))
 
+        # Legislative Decree #208 from Jun 17, 2012.
         if self._year >= 2013:
-            # Legislative Decree #208 from Jun 17, 2012
-            # Fathers' Day.
-            self._add_holiday_jun_17("Fathers' Day")
+            # Father's Day.
+            self._add_holiday_jun_17(tr("Día del Padre"))
 
-        # Feast of San Salvador.
-        self._add_holiday_aug_6("Feast of San Salvador")
+        # Celebrations of San Salvador.
+        self._add_holiday_aug_6(tr("Celebración del Divino Salvador del Mundo"))
 
         # Independence Day.
-        self._add_holiday_sep_15("Independence Day")
+        self._add_holiday_sep_15(tr("Día de la Independencia"))
 
         # All Souls' Day.
-        self._add_all_souls_day("All Souls' Day")
+        self._add_all_souls_day(tr("Día de los Difuntos"))
 
         # Christmas Day.
-        self._add_christmas_day("Christmas Day")
+        self._add_christmas_day(tr("Navidad"))
 
     def _populate_subdiv_ss_public_holidays(self):
-        # San Salvador Day 1.
-        self._add_holiday_aug_3("San Salvador Day 1")
-
-        # San Salvador Day 2.
-        self._add_holiday_aug_5("San Salvador Day 2")
+        # Feast of San Salvador.
+        name = tr("Fiesta de San Salvador")
+        self._add_holiday_aug_3(name)
+        self._add_holiday_aug_5(name)
 
 
 class SV(ElSalvador):

holidays/countries/iran.py

@@ -12,6 +12,7 @@
 
 from gettext import gettext as tr
 
+from holidays.calendars.gregorian import FRI
 from holidays.groups import IslamicHolidays, PersianCalendarHolidays
 from holidays.holiday_base import HolidayBase
 
@@ -21,6 +22,7 @@ class Iran(HolidayBase, IslamicHolidays, PersianCalendarHolidays):
     References:
     - https://en.wikipedia.org/wiki/Public_holidays_in_Iran
     - https://fa.wikipedia.org/wiki/تعطیلات_عمومی_در_ایران
+    - https://en.wikipedia.org/wiki/Workweek_and_weekend
     """
 
     country = "IR"
@@ -29,6 +31,7 @@ class Iran(HolidayBase, IslamicHolidays, PersianCalendarHolidays):
     estimated_label = tr("(تخمین زده) %s")
     supported_languages = ("en_US", "fa")
     start_year = 1980
+    weekend = {FRI}
 
     def __init__(self, *args, **kwargs):
         IslamicHolidays.__init__(self)