holidays 0.60__py3-none-any.whl → 0.62__py3-none-any.whl

holidays/countries/tanzania.py

@@ -64,6 +64,8 @@ class Tanzania(
     # %s (estimated).
     estimated_label = tr("%s (makisio)")
     supported_languages = ("en_US", "sw")
+    # Written Law (Miscellaneous Amendments) (No. 2) Act, 1994.
+    start_year = 1994
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -73,10 +75,6 @@ class Tanzania(
         super().__init__(*args, **kwargs)
 
     def _populate_bank_holidays(self):
-        # Written Law (Miscellaneous Amendments) (No. 2) Act, 1994.
-        if self._year <= 1993:
-            return None
-
         # Sikukuu ya Pasaka.
         # Status: In-Use.
         # Only observed by financial institutions.
@@ -85,10 +83,6 @@ class Tanzania(
         self._add_easter_sunday(tr("Sikukuu ya Pasaka"))
 
     def _populate_public_holidays(self):
-        # Written Law (Miscellaneous Amendments) (No. 2) Act, 1994.
-        if self._year <= 1993:
-            return None
-
         # In-lieus ("Badala ya %s") are observed on Monday should it fall on the weekends.
         # Abrogated in Public Holidays Ordinance  No. 28 of 1966.
         # Reinstituted in Written Law (Miscellaneous Amendments) (No. 2) Act, 1994.

holidays/countries/thailand.py

@@ -40,6 +40,7 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
             - https://resolution.soc.go.th/?prep_id=196007
             - https://github.com/vacanza/holidays/pull/929
             - https://www.thairath.co.th/lifestyle/life/2812118
+            - https://www.thaipbs.or.th/news/content/346216
         - [New Year's Day]
             `wikisource.org <http://tiny.cc/wa_wiki_thai_newyear_2483>`_
         - [National Children's Day]
@@ -142,6 +143,9 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
     # %s (in lieu).
     observed_label = tr("ชดเชย%s")
     supported_languages = ("en_US", "th")
+    # Due to Thai Calendar Migration, this is capped off at 1941.
+    # But certain holidays were implemented before 1941.
+    start_year = 1941
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)
@@ -154,11 +158,6 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
         return 1961 <= self._year <= 1973 or 1995 <= self._year <= 1997 or self._year >= 2001
 
     def _populate_public_holidays(self):
-        # Due to Thai Calendar Migration, this is capped off at 1941.
-        # But certain holidays were implemented before 1941.
-        if self._year <= 1940:
-            return None
-
         # Fixed Date Holidays
 
         # วันขึ้นปีใหม่
@@ -681,10 +680,10 @@ class Thailand(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiC
 
         # วันลอยกระทง
         # Status: In-Use.
+        # Started in 1941.
 
-        if self._year >= 1941:
-            # Loy Krathong
-            self._add_loy_krathong(tr("วันลอยกระทง"))
+        # Loy Krathong
+        self._add_loy_krathong(tr("วันลอยกระทง"))
 
 
 class TH(Thailand):
@@ -832,6 +831,11 @@ class ThailandStaticHolidays:
             (APR, 12, thai_bridge_public_holiday),
             (DEC, 30, thai_bridge_public_holiday),
         ),
+        2025: (
+            (JUN, 2, thai_bridge_public_holiday),
+            (AUG, 11, thai_bridge_public_holiday),
+        ),
+        2026: (JAN, 2, thai_bridge_public_holiday),
     }
     special_workday_holidays = {1999: (MAY, 14, tr("วันพืชมงคล"))}
 

holidays/countries/timor_leste.py

@@ -48,6 +48,8 @@ class TimorLeste(
     # %s (estimated).
     estimated_label = tr("%s (aproximada)")
     supported_languages = ("en_US", "pt_TL", "tet")
+    # Law No. 10/2005 Of 10 August, Public Holidays and Official Commemorative Dates.
+    start_year = 2006
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -57,10 +59,6 @@ class TimorLeste(
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Law No. 10/2005 Of 10 August, Public Holidays and Official Commemorative Dates.
-        if self._year <= 2005:
-            return None
-
         # Fixed Date Public Holidays.
 
         # New Year's Day.
@@ -141,10 +139,6 @@ class TimorLeste(
         self._add_eid_al_adha_day(tr("Idul Adha"))
 
     def _populate_workday_holidays(self):
-        # Law No. 10/2005 Of 10 August, Public Holidays and Official Commemorative Dates.
-        if self._year <= 2005:
-            return None
-
         # Fixed Date Government Holidays.
 
         # World Children's Day.
@@ -486,5 +480,7 @@ class TimorLesteStaticHolidays:
             (SEP, 11, pope_francis_visit),
             # https://timor-leste.gov.tl/?p=40592&lang=en
             (OCT, 31, special_national_holidays),
+            # https://timor-leste.gov.tl/?p=40955&lang=en
+            (NOV, 29, special_national_holidays),
         ),
     }

holidays/countries/tonga.py

@@ -75,6 +75,8 @@ class Tonga(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stati
     # %s (observed).
     observed_label = tr("%s (fakatokanga'i)")
     supported_languages = ("en_US", "to")
+    # Public Holidays Act, 1988 Revision.
+    start_year = 1989
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -89,10 +91,6 @@ class Tonga(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stati
         return super()._add_observed(dt, **kwargs)
 
     def _populate_public_holidays(self):
-        # Public Holidays Act, 1988 Revision.
-        if self._year <= 1988:
-            return None
-
         # New Year's Day.
         jan_1 = self._add_new_years_day(tr("'Uluaki 'Aho 'o e Ta'u Fo'ou"))
         if self._year <= 2016:

holidays/countries/turkey.py

@@ -35,6 +35,8 @@ class Turkey(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays
     estimated_label = tr("%s (tahmini)")
     supported_categories = (HALF_DAY, PUBLIC)
     supported_languages = ("en_US", "tr", "uk")
+    # Law 2739 of 27 May 1935.
+    start_year = 1936
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)
@@ -43,10 +45,6 @@ class Turkey(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Law 2739 of 27 May 1935.
-        if self._year <= 1935:
-            return None
-
         # New Year's Day.
         self._add_new_years_day(tr("Yılbaşı"))
 
@@ -103,9 +101,6 @@ class Turkey(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays
         self._add_eid_al_adha_day_four(name)
 
     def _populate_half_day_holidays(self):
-        if self._year <= 1935:
-            return None
-
         # %s (from 1pm).
         begin_time_label = self.tr("%s (saat 13.00'ten)")
 

holidays/countries/ukraine.py

@@ -35,6 +35,8 @@ class Ukraine(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
     observed_label = tr("%s (вихідний)")
     supported_categories = (PUBLIC, WORKDAY)
     supported_languages = ("ar", "en_US", "uk")
+    # The current set of holidays came into force in 1991.
+    start_year = 1991
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_REVISED_CALENDAR)
@@ -53,10 +55,6 @@ class Ukraine(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
         return date(1995, JAN, 27) <= dt <= date(1998, JAN, 9) or dt >= date(1999, APR, 23)
 
     def _populate_common(self, is_martial_law: bool = False):
-        # The current set of holidays came into force in 1991
-        if self._year <= 1990:
-            return None
-
         # There is no public holidays in Ukraine during the period of martial law
         # https://zakon.rada.gov.ua/laws/show/2136-20#n26
         # law is in force from March 15, 2022

holidays/countries/united_kingdom.py

@@ -51,6 +51,8 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
         "Wales": "WLS",
     }
     _deprecated_subdivisions = ("UK",)
+    # Bank Holidays Act 1871
+    start_year = 1872
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -62,10 +64,6 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self) -> None:
-        # Bank Holidays Act 1871
-        if self._year <= 1871:
-            return None
-
         # Good Friday
         self._add_good_friday("Good Friday")
 
@@ -91,10 +89,6 @@ class UnitedKingdom(ObservedHolidayBase, ChristianHolidays, InternationalHoliday
                 self._add_holiday_last_mon_of_may(name)
 
     def _populate_subdiv_holidays(self):
-        # Bank Holidays Act 1871
-        if self._year <= 1871:
-            return None
-
         if self.subdiv != "SCT":
             # New Year's Day
             if self._year >= 1975:

holidays/countries/united_states.py

@@ -127,6 +127,7 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         "MH",
         "PW",
     )
+    start_year = 1777
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -213,29 +214,25 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
                 self._add_holiday_feb_22(name)
 
         # Columbus Day
-        if self._year >= 1937 and (
-            self.subdiv is None
-            or self.subdiv
-            in {
-                "AS",
-                "AZ",
-                "CT",
-                "GA",
-                "ID",
-                "IL",
-                "IN",
-                "MA",
-                "MD",
-                "MO",
-                "MT",
-                "NJ",
-                "NY",
-                "OH",
-                "PA",
-                "UT",
-                "WV",
-            }
-        ):
+        if self._year >= 1937 and self.subdiv in {
+            "AS",
+            "AZ",
+            "CT",
+            "GA",
+            "ID",
+            "IL",
+            "IN",
+            "MA",
+            "MD",
+            "MO",
+            "MT",
+            "NJ",
+            "NY",
+            "OH",
+            "PA",
+            "UT",
+            "WV",
+        }:
             name = "Columbus Day"
             if self._year >= 1971:
                 self._add_holiday_2nd_mon_of_oct(name)

holidays/countries/uruguay.py

@@ -39,6 +39,8 @@ class Uruguay(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
     default_language = "es"
     supported_categories = (BANK, PUBLIC)
     supported_languages = ("en_US", "es", "uk")
+    # Law # 6997.
+    start_year = 1920
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -52,10 +54,6 @@ class Uruguay(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
         return 1980 <= self._year <= 1983 or self._year >= 1997
 
     def _populate_public_holidays(self):
-        # Law # 6997.
-        if self._year <= 1919:
-            return None
-
         # New Year's Day.
         self._add_new_years_day(tr("Año Nuevo"))
 
@@ -105,9 +103,6 @@ class Uruguay(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
         # These holidays are generally observed by schools, public sector offices, banks,
         # and a few private companies.
 
-        if self._year <= 1919:
-            return None
-
         # Children's Day.
         self._add_holiday_jan_6(tr("Día de los Niños"))
 

holidays/countries/uzbekistan.py

@@ -36,6 +36,7 @@ class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, St
     # %s (observed, estimated).
     observed_estimated_label = tr("%s (ko‘chirilgan, taxminiy)")
     supported_languages = ("en_US", "uk", "uz")
+    start_year = 1992
 
     def __init__(self, *args, **kwargs):
         InternationalHolidays.__init__(self)
@@ -49,8 +50,6 @@ class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, St
         return dt >= date(2023, APR, 30)
 
     def _populate_public_holidays(self):
-        if self._year <= 1991:
-            return None
         dts_observed = set()
 
         # New Year's Day.

holidays/countries/vanuatu.py

@@ -24,6 +24,8 @@ class Vanuatu(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
 
     country = "VU"
     observed_label = "%s (observed)"
+    # On 30 July 1980, Vanuatu gained independence from Britain and France.
+    start_year = 1981
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -33,10 +35,6 @@ class Vanuatu(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # On 30 July 1980, Vanuatu gained independence from Britain and France.
-        if self._year <= 1980:
-            return None
-
         # New Years Day.
         self._add_observed(self._add_new_years_day("New Year's Day"))
 

holidays/countries/vatican_city.py

@@ -23,15 +23,13 @@ class VaticanCity(HolidayBase, ChristianHolidays):
     """
 
     country = "VA"
+    start_year = 1929
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self) -> None:
-        if self._year <= 1928:
-            return None
-
         # Solemnity of Mary Day.
         # This is supposedly the same as International New Year.
         # Modern adoption across the entire Latin Church in 1931 though this

holidays/countries/venezuela.py

@@ -24,6 +24,7 @@ class Venezuela(HolidayBase, ChristianHolidays, InternationalHolidays):
     country = "VE"
     default_language = "es"
     supported_languages = ("en_US", "es", "uk")
+    start_year = 1801
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)

holidays/countries/zambia.py

@@ -25,6 +25,7 @@ class Zambia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
 
     country = "ZM"
     observed_label = "%s (observed)"
+    start_year = 1965
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -34,10 +35,6 @@ class Zambia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Stat
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Observed since 1965
-        if self._year <= 1964:
-            return None
-
         # New Year's Day.
         self._add_observed(self._add_new_years_day("New Year's Day"))
 

holidays/countries/zimbabwe.py

@@ -22,6 +22,7 @@ class Zimbabwe(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
 
     country = "ZW"
     observed_label = "%s (observed)"
+    start_year = 1988
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -30,9 +31,6 @@ class Zimbabwe(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year <= 1987:
-            return None
-
         # New Year's Day.
         self._add_observed(self._add_new_years_day("New Year's Day"))
 

holidays/financial/__init__.py

@@ -12,6 +12,7 @@
 
 # flake8: noqa: F401
 
+from .brasil_bolsa_balcao import BrasilBolsaBalcao, BVMF, B3
 from .european_central_bank import EuropeanCentralBank, ECB, TAR
 from .ice_futures_europe import ICEFuturesEurope, IFEU
 from .ny_stock_exchange import NewYorkStockExchange, NYSE, XNYS

holidays/financial/brasil_bolsa_balcao.py

@@ -0,0 +1,108 @@
+#  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.groups import ChristianHolidays, InternationalHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class BrasilBolsaBalcao(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """
+    Official regulations:
+        - `Decreto n. 155-B, de 14.01.1890 <https://www2.camara.leg.br/legin/fed/decret/1824-1899/decreto-155-b-14-janeiro-1890-517534-publicacaooriginal-1-pe.html>`_
+        - `Decreto n. 19.488, de 15.12.1930 <https://www2.camara.leg.br/legin/fed/decret/1930-1939/decreto-19488-15-dezembro-1930-508040-republicacao-85201-pe.html>`_
+        - `Lei n. 14.759, de 21.12.2023 <https://www2.camara.leg.br/legin/fed/lei/2023/lei-14759-21-dezembro-2023-795091-publicacaooriginal-170522-pl.html>`_
+        - `Resolução n. 2.516, de 29.06.1998 <https://www.bcb.gov.br/pre/normativos/res/1998/pdf/res_2516_v2_P.pdf>`_
+        - `Lei n. 662, de 6.04.1949 <https://www2.camara.leg.br/legin/fed/lei/1940-1949/lei-662-6-abril-1949-347136-publicacaooriginal-1-pl.html>`_
+        - `Lei n. 6.802, de 30.06.1980 <https://www.planalto.gov.br/ccivil_03/leis/l6802.htm>`_
+        - `Decreto n. 19.488, de 15.12.1930 <https://www2.camara.leg.br/legin/fed/decret/1930-1939/decreto-19488-15-dezembro-1930-508040-republicacao-85201-pe.html>`_
+        - `Decreto n. 22.647, de 17.04.1933 <https://www2.camara.leg.br/legin/fed/decret/1930-1939/decreto-22647-17-abril-1933-558774-publicacaooriginal-80337-pe.html>`_
+    Historical data:
+        - `Feriados ANBIMA 2001-2099 <https://www.anbima.com.br/feriados>`_
+        - `Calendario de negociação B3 <https://www.b3.com.br/pt_br/solucoes/plataformas/puma-trading-system/para-participantes-e-traders/calendario-de-negociacao/feriados>`_
+    """
+
+    market = "BVMF"
+    default_language = "pt_BR"
+    supported_languages = ("en_US", "pt_BR", "uk")
+    # Decreto n. 155-B, de 14.01.1890
+    # Curiously enough, 1890 is also the year of foundation of the
+    # São Paulo Stock Exchange, which would later become the B3.
+    start_year = 1890
+
+    def __init__(self, *args, **kwargs) -> None:
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Universal Fraternization Day.
+        self._add_new_years_day(tr("Confraternização Universal"))
+
+        # Carnival.
+        carnival_name = tr("Carnaval")
+        self._add_carnival_monday(carnival_name)
+        self._add_carnival_tuesday(carnival_name)
+
+        # Resolução n. 2.516, de 29.06.1998
+        if self._year <= 1999:
+            # Holy Thursday.
+            self._add_holy_thursday(tr("Quinta-feira Santa"))
+
+        # Good Friday.
+        self._add_good_friday(tr("Sexta-feira Santa"))
+
+        # Tiradentes' Day was revoked by president Getúlio Vargas in
+        # december of 1930, through Decreto n. 19.488, but reinstated
+        # by the same president in 1933, through Decreto n. 22.647.
+        if self._year not in {1931, 1932}:
+            # Tiradentes' Day.
+            self._add_holiday_apr_21(tr("Tiradentes"))
+
+        if self._year >= 1925:
+            # Workers' Day.
+            self._add_labor_day(tr("Dia do Trabalhador"))
+
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Corpus Christi"))
+
+        # Independence Day.
+        self._add_holiday_sep_7(tr("Independência do Brasil"))
+
+        # Lei n. 6.802, de 30.06.1980
+        if self._year >= 1980:
+            # Our Lady of Aparecida.
+            self._add_holiday_oct_12(tr("Nossa Senhora Aparecida"))
+
+        # All Souls' Day.
+        self._add_all_souls_day(tr("Finados"))
+
+        # Republic Proclamation Day.
+        self._add_holiday_nov_15(tr("Proclamação da República"))
+
+        # Lei n. 14.759, de 21.12.2023
+        if self._year >= 2024:
+            # National Day of Zumbi and Black Awareness.
+            self._add_holiday_nov_20(tr("Dia Nacional de Zumbi e da Consciência Negra"))
+
+        if self._year >= 1922:
+            # Christmas Day.
+            self._add_christmas_day(tr("Natal"))
+
+
+class BVMF(BrasilBolsaBalcao):
+    pass
+
+
+class B3(BrasilBolsaBalcao):
+    pass

holidays/financial/european_central_bank.py

@@ -24,6 +24,7 @@ class EuropeanCentralBank(HolidayBase, ChristianHolidays, InternationalHolidays)
     """
 
     market = "ECB"
+    start_year = 2000
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -31,11 +32,7 @@ class EuropeanCentralBank(HolidayBase, ChristianHolidays, InternationalHolidays)
         StaticHolidays.__init__(self, EuropeanCentralBankStaticHolidays)
         super().__init__(*args, **kwargs)
 
-    def _populate(self, year):
-        if year <= 1999:
-            return None
-        super()._populate(year)
-
+    def _populate_public_holidays(self):
         self._add_new_years_day("New Year's Day")
 
         self._add_good_friday("Good Friday")

holidays/financial/ice_futures_europe.py

@@ -24,6 +24,7 @@ class ICEFuturesEurope(ObservedHolidayBase, ChristianHolidays, InternationalHoli
     """
 
     market = "IFEU"
+    start_year = 2014
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -31,11 +32,7 @@ class ICEFuturesEurope(ObservedHolidayBase, ChristianHolidays, InternationalHoli
         kwargs.setdefault("observed_rule", SAT_TO_NONE + SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
-    def _populate(self, year):
-        if year <= 2013:
-            return None
-        super()._populate(year)
-
+    def _populate_public_holidays(self):
         self._move_holiday(self._add_new_years_day("New Year's Day"))
 
         self._add_good_friday("Good Friday")