holidays 0.86__py3-none-any.whl → 0.88__py3-none-any.whl

holidays/countries/germany.py

@@ -21,25 +21,39 @@ from holidays.holiday_base import HolidayBase
 class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
     """Germany holidays.
 
-    This class doesn't return any holidays before 1990-10-03.
-
-    Before that date the current Germany was separated into the "German Democratic
-    Republic" and the "Federal Republic of Germany" which both had somewhat
-    different holidays. Since this class is called "Germany" it doesn't really
-     make sense to include the days from the two former countries.
-
-    "Mariä Himmelfahrt" is only a holiday in Bavaria (BY) and "Fronleichnam"
-    in Saxony (SN) and Thuringia (TH) if municipality is mostly catholic which
-    in term depends on census data. It's listed in "CATHOLIC" category for these provinces.
-
     References:
+        * <https://de.wikipedia.org/wiki/Feiertag_(Deutschland)>
         * <https://en.wikipedia.org/wiki/Public_holidays_in_Germany>
-        * [Bavaria's Feiertagsgesetz](https://web.archive.org/web/20250724092008/https://www.gesetze-bayern.de/Content/Document/BayFTG-1)
+        * [German Unity Day](https://web.archive.org/web/20251011161644/https://www.gesetze-im-internet.de/einigvtr/art_2.html)
+
+    Subdivisions Holidays References:
+        * [Brandenburg](https://web.archive.org/web/20251002092001/https://bravors.brandenburg.de/gesetze/ftg_2015)
+        * [Berlin](https://web.archive.org/web/20250518234750/http://gesetze.berlin.de/bsbe/document/jlr-FeiertGBEV10P1)
+        * [Baden-Württemberg](https://web.archive.org/web/20240914215438/https://www.landesrecht-bw.de/bsbw/document/jlr-FeiertGBWpP1)
+        * [Bayern](https://web.archive.org/web/20250906201237/https://www.gesetze-bayern.de/Content/Document/BayFTG/true)
+        * [Bremen](https://web.archive.org/web/20240430101614/https://www.transparenz.bremen.de/metainformationen/gesetz-ueber-die-sonn-gedenk-und-feiertage-vom-12-november-1954-145882)
+        * [Hessen](https://web.archive.org/web/20250421183249/http://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952rahmen)
+        * [Hamburg](https://web.archive.org/web/20250618110249/https://www.landesrecht-hamburg.de/bsha/document/jlr-FeiertGHAV3P1)
+        * [Mecklenburg-Vorpommern](https://web.archive.org/web/20250222090126/https://www.landesrecht-mv.de/bsmv/document/jlr-FTGMVV3P2)
+        * [Niedersachsen](https://web.archive.org/web/20250627100126/https://voris.wolterskluwer-online.de/browse/document/b724111b-6c20-3862-b111-589842acacba)
+        * [Nordrhein-Westfalen](https://web.archive.org/web/20250717194916/https://recht.nrw.de/lmi/owa/br_bes_detail?bes_id=3367&aufgehoben=N&det_id=144445&anw_nr=2&menu=1&sg=0)
+        * [Rheinland-Pfalz](https://web.archive.org/web/20250521153233/http://www.landesrecht.rlp.de/bsrp/document/jlr-FeiertGRPpP2)
+        * [Schleswig-Holstein](https://web.archive.org/web/20250812223916/https://www.gesetze-rechtsprechung.sh.juris.de/bssh/document/jlr-FeiertGSH2004V3P2)
+        * [Saarland](https://web.archive.org/web/20250124112139/http://recht.saarland.de/bssl/document/jlr-FeiertGSL1976V6P2)
+        * [Sachsen](https://web.archive.org/web/20250808020452/https://www.revosax.sachsen.de/vorschrift/3997-SaechsSFG)
+        * [Sachsen-Anhalt](https://web.archive.org/web/20250615214949/http://www.landesrecht.sachsen-anhalt.de/bsst/document/jlr-FeiertGSTpP2)
+        * [Thüringen](https://web.archive.org/web/20250712163548/http://landesrecht.thueringen.de/bsth/document/jlr-FeiertGTHV5P2)
+
+    !!! note "Note"
+        "Mariä Himmelfahrt" is only a holiday in Bavaria (BY) and "Fronleichnam"
+        in Saxony (SN) and Thuringia (TH) if municipality is mostly catholic which
+        in term depends on census data. It's listed in "CATHOLIC" category for these provinces.
     """
 
     country = "DE"
     default_language = "de"
-    start_year = 1990
+    # Germany reunification was completed on Oct 3, 1990.
+    start_year = 1991
     subdivisions = (
         # States.
         "BB",  # Brandenburg.
@@ -90,24 +104,23 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        if self._year >= 1991:
-            # New Year's Day.
-            self._add_new_years_day(tr("Neujahr"))
+        # New Year's Day.
+        self._add_new_years_day(tr("Neujahr"))
 
-            # Good Friday.
-            self._add_good_friday(tr("Karfreitag"))
+        # Good Friday.
+        self._add_good_friday(tr("Karfreitag"))
 
-            # Easter Monday.
-            self._add_easter_monday(tr("Ostermontag"))
+        # Easter Monday.
+        self._add_easter_monday(tr("Ostermontag"))
 
-            # Labor Day.
-            self._add_labor_day(tr("Erster Mai"))
+        # Labor Day.
+        self._add_labor_day(tr("Erster Mai"))
 
-            # Ascension Day.
-            self._add_ascension_thursday(tr("Christi Himmelfahrt"))
+        # Ascension Day.
+        self._add_ascension_thursday(tr("Christi Himmelfahrt"))
 
-            # Whit Monday.
-            self._add_whit_monday(tr("Pfingstmontag"))
+        # Whit Monday.
+        self._add_whit_monday(tr("Pfingstmontag"))
 
         # German Unity Day.
         self._add_holiday_oct_3(tr("Tag der Deutschen Einheit"))
@@ -126,47 +139,43 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             self._populate_subdiv_by_public_holidays()
 
     def _populate_subdiv_bb_public_holidays(self):
-        if self._year >= 1991:
-            # Easter Sunday.
-            self._add_easter_sunday(tr("Ostersonntag"))
+        # Easter Sunday.
+        self._add_easter_sunday(tr("Ostersonntag"))
 
-            # Whit Sunday.
-            self._add_whit_sunday(tr("Pfingstsonntag"))
+        # Whit Sunday.
+        self._add_whit_sunday(tr("Pfingstsonntag"))
 
         # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_be_public_holidays(self):
         if self._year >= 2019:
-            # International Women's Day.
-            self._add_womens_day(tr("Internationaler Frauentag"))
+            # Women's Day.
+            self._add_womens_day(tr("Frauentag"))
 
     def _populate_subdiv_bw_public_holidays(self):
-        if self._year >= 1991:
-            # Epiphany.
-            self._add_epiphany_day(tr("Heilige Drei Könige"))
+        # Epiphany.
+        self._add_epiphany_day(tr("Heilige Drei Könige"))
 
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_by_public_holidays(self):
-        if self._year >= 1991:
-            # Epiphany.
-            self._add_epiphany_day(tr("Heilige Drei Könige"))
+        # Epiphany.
+        self._add_epiphany_day(tr("Heilige Drei Könige"))
 
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_by_catholic_holidays(self):
-        if self._year >= 1991:
-            # Assumption Day.
-            self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
+        # Assumption Day.
+        self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
     def _populate_subdiv_hb_public_holidays(self):
         if self._year >= 2018:
@@ -174,9 +183,8 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_he_public_holidays(self):
-        if self._year >= 1991:
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
     def _populate_subdiv_hh_public_holidays(self):
         if self._year >= 2018:
@@ -185,8 +193,8 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
 
     def _populate_subdiv_mv_public_holidays(self):
         if self._year >= 2023:
-            # International Women's Day.
-            self._add_womens_day(tr("Internationaler Frauentag"))
+            # Women's Day.
+            self._add_womens_day(tr("Frauentag"))
 
         # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
@@ -197,17 +205,15 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_nw_public_holidays(self):
-        if self._year >= 1991:
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
 
     def _populate_subdiv_rp_public_holidays(self):
-        if self._year >= 1991:
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
@@ -218,12 +224,11 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_sl_public_holidays(self):
-        if self._year >= 1991:
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
-            # Assumption Day.
-            self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
+        # Assumption Day.
+        self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
@@ -237,14 +242,12 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
             self._add_holiday_1st_wed_before_nov_22(tr("Buß- und Bettag"))
 
     def _populate_subdiv_sn_catholic_holidays(self):
-        if self._year >= 1991:
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
     def _populate_subdiv_st_public_holidays(self):
-        if self._year >= 1991:
-            # Epiphany.
-            self._add_epiphany_day(tr("Heilige Drei Könige"))
+        # Epiphany.
+        self._add_epiphany_day(tr("Heilige Drei Könige"))
 
         # Reformation Day.
         self._add_holiday_oct_31(tr("Reformationstag"))
@@ -258,16 +261,14 @@ class Germany(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolid
         self._add_holiday_oct_31(tr("Reformationstag"))
 
     def _populate_subdiv_th_catholic_holidays(self):
-        if self._year >= 1991:
-            # Corpus Christi.
-            self._add_corpus_christi_day(tr("Fronleichnam"))
+        # Corpus Christi.
+        self._add_corpus_christi_day(tr("Fronleichnam"))
 
     def _populate_subdiv_augsburg_public_holidays(self):
         self._populate_subdiv_by_public_holidays()
 
-        if self._year >= 1991:
-            # Augsburg Peace Festival.
-            self._add_holiday_aug_8(tr("Augsburger Hohes Friedensfest"))
+        # Augsburg Peace Festival.
+        self._add_holiday_aug_8(tr("Augsburger Hohes Friedensfest"))
 
 
 class DE(Germany):

holidays/countries/guam.py

@@ -10,6 +10,7 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import UnitedStates
 from holidays.mixins.child_entity import ChildEntity
 
@@ -25,6 +26,7 @@ class Guam(ChildEntity, UnitedStates):
     parent_entity = UnitedStates
     # Became a U.S. Territory on April 11th, 1899.
     start_year = 1900
+    supported_categories = (PUBLIC, UNOFFICIAL)
 
 
 class HolidaysGU(Guam):

holidays/countries/india.py

@@ -37,6 +37,8 @@ class India(
         * <https://web.archive.org/web/20250413193633/https://www.calendarlabs.com/holidays/india/2021>
         * <https://web.archive.org/web/20231118175007/http://slusi.dacnet.nic.in/watershedatlas/list_of_state_abbreviation.htm>
         * <https://web.archive.org/web/20231008063930/https://vahan.parivahan.gov.in/vahan4dashboard/>
+        * Gujarat:
+            * <https://gad.gujarat.gov.in/personnel/Images/pdf/general_holidays_2026_guj.pdf>
         * Tamil Nadu:
             * [Tamil Monthly Calendar](https://web.archive.org/web/20231228103352/https://www.tamildailycalendar.com/tamil_monthly_calendar.php)
             * [Tamil Calendar](https://web.archive.org/web/20250429125140/https://www.prokerala.com/general/calendar/tamilcalendar.php)
@@ -144,7 +146,7 @@ class India(
         "West Bengal": "WB",
     }
     supported_categories = (OPTIONAL, PUBLIC)
-    supported_languages = ("en_IN", "en_US", "hi")
+    supported_languages = ("en_IN", "en_US", "gu", "hi")
     _deprecated_subdivisions = (
         "DD",  # Daman and Diu.
         "OR",  # Orissa.
@@ -456,7 +458,7 @@ class India(
         # Dr. B. R. Ambedkar Jayanti.
         self._add_holiday_apr_14(tr("Dr. B. R. Ambedkar's Jayanti"))
         # Maharana Pratap Jayanti.
-        self._add_holiday_jun_15(tr("Maharana Pratap Jayanti"))
+        self._add_maharana_pratap_jayanti(tr("Maharana Pratap Jayanti"))
 
     # Sikkim.
     def _populate_subdiv_sk_public_holidays(self):
@@ -485,7 +487,7 @@ class India(
         # Telangana Formation Day.
         self._add_holiday_jun_2(tr("Telangana Formation Day"))
         # Bathukamma Festival.
-        self._add_holiday_oct_6(tr("Bathukamma Festival"))
+        self._add_bathukamma(tr("Bathukamma Festival"))
         # Ugadi.
         self._add_gudi_padwa(tr("Ugadi"))
 

holidays/countries/macau.py

@@ -24,6 +24,8 @@ from holidays.observed_holiday_base import (
     ObservedHolidayBase,
     SUN_TO_NEXT_WORKDAY,
     SAT_SUN_TO_NEXT_WORKDAY,
+    SAT_TO_NONE,
+    SUN_TO_NONE,
 )
 
 
@@ -92,19 +94,7 @@ class Macau(
         kwargs.setdefault("observed_since", 2011)
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
-        """Macau Mandatory (Statutory) Holidays.
-
-        Decreto-Lei n.º 101/84/M - Earliest Available Version Online.
-        Decreto-Lei n.º 24/89/M - Added Ching Ming Festival.
-        Lei n.º 8/2000 - Removed Day of Portugal
-                       - Added Macao S.A.R. Establishment Day.
-                       - Moved Mid-Autumn to Day following Mid-Autumn to match Public Holidays.
-        Lei n.º 7/2008 - Consolidated with other laws, reaffirming 2000 Amendment list.
-        """
-        if self._year <= 1984:
-            return None
-
+    def _populate_common(self):
         # New Year's Day.
         self._add_new_years_day(tr("元旦"))
 
@@ -126,6 +116,21 @@ class Macau(
         # National Day of the People's Republic of China.
         self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
 
+    def _populate_public_holidays(self):
+        """Macau Mandatory (Statutory) Holidays.
+
+        Decreto-Lei n.º 101/84/M - Earliest Available Version Online.
+        Decreto-Lei n.º 24/89/M - Added Ching Ming Festival.
+        Lei n.º 8/2000 - Removed Day of Portugal
+                       - Added Macao S.A.R. Establishment Day.
+                       - Moved Mid-Autumn to Day following Mid-Autumn to match Public Holidays.
+        Lei n.º 7/2008 - Consolidated with other laws, reaffirming 2000 Amendment list.
+        """
+        if self._year <= 1984:
+            return None
+
+        self._populate_common()
+
         # Decreto-Lei n.º 24/89/M - Adds Ching Ming as a Mandatory Holiday.
         if self._year >= 1989:
             # Tomb-Sweeping Day.
@@ -150,17 +155,7 @@ class Macau(
 
     def _populate_optional_holidays(self):
         """Macau General Holidays."""
-        # New Year's Day.
-        self._add_new_years_day(tr("元旦"))
-
-        # Chinese New Year's Day.
-        self._add_chinese_new_years_day(tr("農曆正月初一"))
-
-        # The second day of Chinese New Year.
-        self._add_chinese_new_years_day_two(tr("農曆正月初二"))
-
-        # The third day of Chinese New Year.
-        self._add_chinese_new_years_day_three(tr("農曆正月初三"))
+        self._populate_common()
 
         # Tomb-Sweeping Day.
         self._add_qingming_festival(tr("清明節"))
@@ -183,21 +178,12 @@ class Macau(
             else tr("聖周星期六")
         )
 
-        # Labor Day.
-        self._add_labor_day(tr("勞動節"))
-
         # Dragon Boat Festival.
         self._add_dragon_boat_festival(tr("端午節"))
 
-        # Double Ninth Festival.
-        self._add_double_ninth_festival(tr("重陽節"))
-
         # The Day following Mid-Autumn Festival.
         self._add_mid_autumn_festival_day_two(tr("中秋節翌日"))
 
-        # National Day of the People's Republic of China.
-        self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
-
         # All Soul's Day.
         self._add_all_souls_day(tr("追思節"))
 
@@ -293,18 +279,12 @@ class Macau(
         # New Year's Day.
         dts_observed.add(self._add_new_years_day(tr("元旦")))
 
-        if self._year not in {2006, 2007, 2009, 2010, 2012, 2013, 2016, 2023}:
+        if not (
+            self._is_sunday(self._chinese_new_year) or self._is_monday(self._chinese_new_year)
+        ):
             # Chinese New Year's Eve.
             self._add_chinese_new_years_eve(begin_time_label % self.tr("農曆除夕"))
 
-        if self._year in {2006, 2007, 2010, 2013, 2014, 2017, 2018}:
-            # The fourth day of Chinese New Year.
-            self._add_chinese_new_years_day_four(tr("農曆正月初四"))
-
-        if self._year in {2014, 2015, 2017, 2018}:
-            # The fifth day of Chinese New Year.
-            self._add_chinese_new_years_day_five(tr("農曆正月初五"))
-
         if self._year >= 2019:
             # Chinese New Year's Day.
             dts_observed.add(self._add_chinese_new_years_day(tr("農曆正月初一")))
@@ -314,6 +294,17 @@ class Macau(
 
             # The third day of Chinese New Year.
             dts_observed.add(self._add_chinese_new_years_day_three(tr("農曆正月初三")))
+        else:
+            if self._is_friday(self._chinese_new_year) or self._is_weekend(self._chinese_new_year):
+                # The fourth day of Chinese New Year.
+                self._add_chinese_new_years_day_four(tr("農曆正月初四"))
+            if self._year >= 2012 and (
+                self._is_thursday(self._chinese_new_year)
+                or self._is_friday(self._chinese_new_year)
+                or self._is_saturday(self._chinese_new_year)
+            ):
+                # The fifth day of Chinese New Year.
+                self._add_chinese_new_years_day_five(tr("農曆正月初五"))
 
         # The Day before Easter.
         dts_observed.add(self._add_holy_saturday(tr("復活節前日")))
@@ -361,9 +352,12 @@ class Macau(
         dts_observed.add(self._add_christmas_day(tr("聖誕節")))
 
         # 2012's Full-Day New Year's Eve is declared discretely.
-        if self._year >= 2007 and self._year not in {2011, 2012, 2016, 2017, 2022, 2023}:
-            # New Year's Eve.
-            self._add_new_years_eve(begin_time_label % self.tr("除夕"))
+        if self._year >= 2007 and self._year != 2012:
+            self._move_holiday(
+                # New Year's Eve.
+                self._add_new_years_eve(begin_time_label % self.tr("除夕")),
+                rule=SAT_TO_NONE + SUN_TO_NONE,
+            )
 
         if self.observed:
             self.observed_label = (