holidays 0.68__py3-none-any.whl → 0.70__py3-none-any.whl

holidays/countries/luxembourg.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -17,8 +17,10 @@ from holidays.holiday_base import HolidayBase
 
 
 class Luxembourg(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Luxembourg
+    """Luxembourg holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Luxembourg>
     """
 
     country = "LU"

holidays/countries/macau.py

@@ -0,0 +1,480 @@
+#  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.md 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.gregorian import FEB, SEP, OCT, DEC
+from holidays.constants import GOVERNMENT, MANDATORY, PUBLIC
+from holidays.groups import (
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    StaticHolidays,
+)
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    SUN_TO_NEXT_WORKDAY,
+    SAT_SUN_TO_NEXT_WORKDAY,
+)
+
+
+class Macau(
+    ObservedHolidayBase,
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    StaticHolidays,
+):
+    """Macau holidays.
+
+    References:
+        * [Decreto-Lei n.º 4/82/M](https://bo.io.gov.mo/bo/i/82/04/declei04.asp)
+        * [Decreto-Lei n.º 38/87/M](https://bo.io.gov.mo/bo/i/87/25/declei38.asp)
+        * [Decreto-Lei n.º 15/93/M](https://bo.io.gov.mo/bo/i/93/17/declei15.asp)
+        * [Decreto-Lei n.º 7/97/M](https://bo.io.gov.mo/bo/i/97/11/declei07.asp)
+        * [Portaria n.º 85/97/M](https://bo.io.gov.mo/bo/i/97/15/port85.asp)
+        * [Portaria n.º 242/98/M](https://bo.io.gov.mo/bo/i/98/48/port242.asp)
+        * [Regulamento Administrativo n.º 4/1999](https://bo.io.gov.mo/bo/i/1999/01/regadm04.asp)
+        * [Regulamento Administrativo n.º 5/1999](https://bo.io.gov.mo/bo/i/1999/01/regadm05.asp)
+        * [Ordem Executiva n.º 60/2000](https://bo.io.gov.mo/bo/i/2000/40/ordem60.asp)
+        * [Lei n.º 27/2024](https://bo.io.gov.mo/bo/i/2025/01/lei27.asp#an2l63)
+
+    Mandatory Holidays References:
+        * [Decreto-Lei n.º 101/84/M](https://bo.io.gov.mo/bo/i/84/35/declei101.asp)
+        * [Decreto-Lei n.º 24/89/M](https://bo.io.gov.mo/bo/i/89/14/declei24.asp)
+        * [Lei n.º 8/2000](https://bo.io.gov.mo/bo/i/2000/19/lei08.asp)
+        * [Lei n.º 7/2008](https://bo.io.gov.mo/bo/i/2008/33/lei07.asp)
+
+    Cross-Checking:
+        * [Public Holidays for 2017–2025](https://www.gov.mo/en/public-holidays/year-2017/)
+        * [Public Holidays for 2005-2018](https://web.archive.org/web/20171207162948/http://portal.gov.mo/web/guest/info_detail?infoid=1887061)
+        * [Mandatory Holidays for 2009-2029](https://www.dsal.gov.mo/pt/standard/holiday_table.html)
+    """
+
+    country = "MO"
+    default_language = "zh_MO"
+    subdivisions = (
+        "I",  # Ilhas.
+        "M",  # Macau.
+    )
+    subdivisions_aliases = {
+        # Municipalities.
+        "Concelho das Ilhas": "I",
+        "海島市": "I",
+        "海岛市": "I",
+        "Concelho de Macau": "M",
+        "澳門市": "M",
+        "澳门市": "M",
+    }
+    supported_categories = (GOVERNMENT, MANDATORY, PUBLIC)
+    supported_languages = ("en_MO", "en_US", "pt_MO", "th", "zh_CN", "zh_MO")
+    # Decreto-Lei n.º 4/82/M.
+    start_year = 1982
+
+    def __init__(self, *args, **kwargs):
+        ChineseCalendarHolidays.__init__(self)
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, MacauStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_WORKDAY)
+        # Systemic in-lieus starts in 2011.
+        kwargs.setdefault("observed_since", 2011)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # 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("農曆正月初三"))
+
+        # Tomb-Sweeping Day.
+        self._add_qingming_festival(tr("清明節"))
+
+        # Regulamento Administrativo n.º 4/1999 - Name changed in Chinese for Good Friday.
+        name = (
+            # Good Friday.
+            tr("耶穌受難日")
+            if self._year >= 2000
+            # Good Friday.
+            else tr("聖周星期五")
+        )
+        self._add_good_friday(name)
+
+        # Regulamento Administrativo n.º 4/1999 - Name changed to The Day before Easter.
+        name = (
+            # The Day before Easter.
+            tr("復活節前日")
+            if self._year >= 2000
+            # Holy Saturday.
+            else tr("聖周星期六")
+        )
+        self._add_holy_saturday(name)
+
+        # 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("追思節"))
+
+        # Immaculate Conception.
+        self._add_immaculate_conception_day(tr("聖母無原罪瞻禮"))
+
+        # Regulamento Administrativo n.º 4/1999 - Moved from DEC 22 to DEC 21.
+        # Ordem Executiva n.º 60/2000 - Switched to Movable.
+
+        # Winter Solstice.
+        name = tr("冬至")
+        if self._year >= 2001:
+            self._add_dongzhi_festival(name)
+        elif self._year == 2000:
+            self._add_holiday_dec_21(name)
+        else:
+            self._add_holiday_dec_22(name)
+
+        # Portaria n.º 242/98/M - Name changed in Chinese for Christmas Eve.
+        # Regulamento Administrativo n.º 4/1999 - Further Chinese name standardization.
+        if self._year >= 2000:
+            # Christmas Eve.
+            name = tr("聖誕節前日")
+        elif self._year == 1999:
+            # Christmas Eve.
+            name = tr("聖誕節前夕")
+        else:
+            # Christmas Eve.
+            name = tr("聖誕前夕")
+        self._add_christmas_eve(name)
+
+        # Portaria n.º 242/98/M - Name changed in Chinese for Christmas Day.
+        name = (
+            # Christmas Day.
+            tr("聖誕節")
+            if self._year >= 1999
+            # Christmas Day.
+            else tr("聖誕")
+        )
+        self._add_christmas_day(name)
+
+        # Decreto-Lei n.º 38/87/M - Removed Assumption Day and All Saints' Day as Public Holiday.
+        if self._year <= 1986:
+            # Assumption Day.
+            self._add_assumption_of_mary_day(tr("聖母升天"))
+
+            # All Saints' Day.
+            self._add_all_saints_day(tr("諸聖節"))
+
+        # Decreto-Lei n.º 38/87/M - Removed Corpus Christi as Public Holiday.
+        if self._year <= 1987:
+            # Corpus Christi.
+            self._add_corpus_christi_day(tr("基督聖體聖血節"))
+
+        # Portaria n.º 242/98/M - De Facto adds Macao S.A.R. Establishment Day on DEC 20 for 1999.
+        # Regulamento Administrativo n.º 5/1999 - Special Name for 1999 (see StaticHolidays).
+        # Ordem Executiva n.º 60/2000 - Removed all Portugal-derived holidays.
+        #                             - Adds The Buddha's Birthday.
+        #                             - Adds The day following National Day of the PRC on OCT 2.
+        #                             - Adds "Anniversary of " to Macao S.A.R. holiday in Chinese.
+        if self._year <= 1999:
+            # Freedom Day.
+            self._add_holiday_apr_25(tr("自由日"))
+
+            # Day of Portugal, Camões, and the Portuguese Communities.
+            self._add_holiday_jun_10(tr("葡國日、賈梅士日暨葡僑日"))
+
+            # Republic Day.
+            self._add_holiday_oct_5(tr("葡萄牙共和國國慶日"))
+
+            # Restoration of Independence Day.
+            self._add_holiday_dec_1(tr("恢復獨立紀念日"))
+        else:
+            # The Buddha's Birthday.
+            self._add_chinese_birthday_of_buddha(tr("佛誕節"))
+
+            # The day following National Day of the People's Republic of China.
+            self._add_holiday_oct_2(tr("中華人民共和國國慶日翌日"))
+
+            # Macao S.A.R. Establishment Day.
+            self._add_holiday_dec_20(tr("澳門特別行政區成立紀念日"))
+
+    def _populate_mandatory_holidays(self):
+        """
+        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
+
+        # 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("農曆正月初三"))
+
+        # Labor Day.
+        self._add_labor_day(tr("勞動節"))
+
+        # Double Ninth Festival.
+        self._add_double_ninth_festival(tr("重陽節"))
+
+        # National Day of the People's Republic of China.
+        self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
+
+        # Decreto-Lei n.º 24/89/M - Adds Ching Ming as a Mandatory Holiday.
+        if self._year >= 1989:
+            # Tomb-Sweeping Day.
+            self._add_qingming_festival(tr("清明節"))
+
+        # Lei n.º 8/2000 - Removed Day of Portugal as a Mandatory Holiday.
+        #                - Changed observance from Mid-Autumn to the following day.
+        #                - Adds Macao S.A.R. Establishment Day as a Mandatory Holiday.
+        if self._year <= 1999:
+            # Day of Portugal, Camões, and the Portuguese Communities.
+            self._add_holiday_jun_10(tr("葡國日、賈梅士日暨葡僑日"))
+
+            # Mid-Autumn Festival.
+            self._add_mid_autumn_festival(tr("中秋節"))
+
+        else:
+            # The Day following Mid-Autumn Festival.
+            self._add_mid_autumn_festival_day_two(tr("中秋節翌日"))
+
+            # Macao S.A.R. Establishment Day.
+            self._add_holiday_dec_20(tr("澳門特別行政區成立紀念日"))
+
+    def _populate_government_holidays(self):
+        # While Cross-Checking References are available for from 2005-2025,
+        # SUN in-lieus starts in 2011; SAT-SUN in-lieus starts in 2012.
+        if self._year <= 2004:
+            return None
+
+        dts_observed = set()
+
+        # %s (Afternoon).
+        begin_time_label = self.tr("%s（下午）")
+
+        # 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}:
+            # 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("農曆正月初一")))
+
+            # The second day of Chinese New Year.
+            dts_observed.add(self._add_chinese_new_years_day_two(tr("農曆正月初二")))
+
+            # The third day of Chinese New Year.
+            dts_observed.add(self._add_chinese_new_years_day_three(tr("農曆正月初三")))
+
+        # The Day before Easter.
+        dts_observed.add(self._add_holy_saturday(tr("復活節前日")))
+
+        # Tomb-Sweeping Day.
+        dts_observed.add(self._add_qingming_festival(tr("清明節")))
+
+        # Labor Day.
+        dts_observed.add(self._add_labor_day(tr("勞動節")))
+
+        # The Buddha's Birthday.
+        dts_observed.add(self._add_chinese_birthday_of_buddha(tr("佛誕節")))
+
+        # Dragon Boat Festival.
+        dts_observed.add(self._add_dragon_boat_festival(tr("端午節")))
+
+        # The Day following Mid-Autumn Festival.
+        dts_observed.add(self._add_mid_autumn_festival_day_two(tr("中秋節翌日")))
+
+        # Double Ninth Festival.
+        dts_observed.add(self._add_double_ninth_festival(tr("重陽節")))
+
+        # National Day of the People's Republic of China.
+        dts_observed.add(self._add_holiday_oct_1(tr("中華人民共和國國慶日")))
+
+        # The day following National Day of the People's Republic of China.
+        dts_observed.add(self._add_holiday_oct_2(tr("中華人民共和國國慶日翌日")))
+
+        # All Soul's Day.
+        dts_observed.add(self._add_all_souls_day(tr("追思節")))
+
+        # Immaculate Conception.
+        dts_observed.add(self._add_immaculate_conception_day(tr("聖母無原罪瞻禮")))
+
+        # Macao S.A.R. Establishment Day.
+        dts_observed.add(self._add_holiday_dec_20(tr("澳門特別行政區成立紀念日")))
+
+        # Winter Solstice.
+        dts_observed.add(self._add_dongzhi_festival(tr("冬至")))
+
+        # Christmas Eve.
+        dts_observed.add(self._add_christmas_eve(tr("聖誕節前日")))
+
+        # Christmas Day.
+        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.observed:
+            self.observed_label = (
+                # Compensatory rest day for %s.
+                self.tr("%s的補假")
+                if self._year >= 2020
+                # The first working day after %s.
+                else self.tr("%s後首個工作日")
+            )
+            # Prior to 2012, in-lieus are only given for holidays which falls on Sunday.
+            self._observed_rule = (
+                SUN_TO_NEXT_WORKDAY if self._year <= 2011 else SAT_SUN_TO_NEXT_WORKDAY
+            )
+            self._populate_observed(dts_observed, multiple=True)
+
+    def _populate_subdiv_i_public_holidays(self):
+        # Decreto-Lei n.º 15/93/M - Moved Day of the Municipality of Ilhas from JUL 13 to NOV 30.
+        # Regulamento Administrativo n.º 4/1999 - Removed as a Public Holiday.
+        if self._year <= 1999:
+            # Day of the Municipality of Ilhas.
+            name = tr("海島市日")
+            if self._year <= 1992:
+                self._add_holiday_nov_30(name)
+            else:
+                self._add_holiday_jul_13(name)
+
+    def _populate_subdiv_m_public_holidays(self):
+        # Regulamento Administrativo n.º 4/1999 - Removed Macau City Day as a Public Holiday.
+        if self._year <= 1999:
+            # Macau City Day.
+            self._add_holiday_jun_24(tr("澳門市日"))
+
+
+class MO(Macau):
+    pass
+
+
+class MAC(Macau):
+    pass
+
+
+class MacauStaticHolidays:
+    """Macau special holidays.
+
+    Special Public and Government Holidays:
+        * <https://www.io.gov.mo/pt/legis/rec/111020>
+
+    Special Mandatory Holidays:
+        * <https://www.dsal.gov.mo/pt/standard/holiday_table.html>
+
+    Cross-Checking:
+        * [Public Holidays for 2017–2025](https://www.gov.mo/en/public-holidays/year-2017/)
+        * [Public Holidays for 2005-2018](https://web.archive.org/web/20171207162948/http://portal.gov.mo/web/guest/info_detail?infoid=1887061)
+    """
+
+    # Additional Public Holiday.
+    name_fullday = tr("額外公眾假期")
+
+    # Additional Half-Day Public Holiday.
+    name_halfday = tr("額外公眾半日假")
+
+    # 70th Anniversary of the Victory of the Chinese People's War of Resistance against
+    # Japanese Aggression and the World Anti-Fascist War.
+    name_70th_war_of_resistance = tr("中國人民抗日戰爭暨世界反法西斯戰爭勝利七十周年紀念日")
+
+    # Overlapping of the Day following National Day of the People's Republic of China
+    # and the Day following Mid-Autumn Festival.
+    name_mid_autumn_festival_day_2_national_day_2_overlap = tr(
+        "中華人民共和國國慶日翌日及中秋節翌日重疊"
+    )
+
+    # Overlapping of the Day following National Day of the People's Republic of China
+    # and the Double Ninth Festival.
+    name_double_ninth_festival_national_day_2_overlap = tr("中華人民共和國國慶日翌日及重陽節重疊")
+
+    # Overlapping of the National Day of the People's Republic of China
+    # and the Day following Mid-Autumn Festival.
+    name_mid_autumn_festival_day_2_national_day_overlap = tr(
+        "中華人民共和國國慶日及中秋節翌日重疊"
+    )
+
+    # New Year's Eve.
+    name_new_years_eve = tr("除夕")
+
+    special_government_holidays = {
+        # Additional Government Holiday.
+        2008: (DEC, 22, tr("額外政府假期")),
+        2012: (
+            (OCT, 3, name_mid_autumn_festival_day_2_national_day_overlap),
+            (DEC, 31, name_new_years_eve),
+        ),
+        2014: (OCT, 3, name_double_ninth_festival_national_day_2_overlap),
+        2020: (OCT, 5, name_mid_autumn_festival_day_2_national_day_2_overlap),
+    }
+    special_mandatory_holidays = {
+        2015: (SEP, 3, name_70th_war_of_resistance),
+    }
+    special_public_holidays = {
+        1998: (
+            (DEC, 23, name_fullday),
+            (DEC, 31, name_halfday),
+        ),
+        1999: (
+            (FEB, 15, name_fullday),
+            # The Handover of Macau to China and the Establishment of the Macau
+            # Special Administrative Region of the People's Republic of China.
+            (DEC, 20, tr("澳門回歸祖國暨中華人民共和國澳門特別行政區成立日")),
+            # The day following the Handover of Macau to China and the Establishment of the Macau
+            # Special Administrative Region of the People's Republic of China.
+            (DEC, 21, tr("澳門回歸祖國暨中華人民共和國澳門特別行政區成立日翌日")),
+            (DEC, 31, name_halfday),
+        ),
+        2000: (FEB, 4, name_halfday),
+        2015: (SEP, 3, name_70th_war_of_resistance),
+    }

holidays/countries/madagascar.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -18,10 +18,11 @@ from holidays.holiday_base import HolidayBase
 
 
 class Madagascar(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Madagascar holidays.
+
     References:
-        - https://www.officeholidays.com/countries/madagascar
-        - https://www.timeanddate.com/holidays/madagascar/
+        * <https://www.officeholidays.com/countries/madagascar>
+        * <https://www.timeanddate.com/holidays/madagascar/>
     """
 
     country = "MG"

holidays/countries/malawi.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -19,9 +19,11 @@ from holidays.observed_holiday_base import (
 
 
 class Malawi(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    https://www.officeholidays.com/countries/malawi
-    https://www.timeanddate.com/holidays/malawi/
+    """Malawi holidays.
+
+    References:
+        * <https://www.officeholidays.com/countries/malawi>
+        * <https://www.timeanddate.com/holidays/malawi/>
     """
 
     country = "MW"

holidays/countries/malaysia.py

@@ -4,12 +4,13 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md 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 datetime import date
 from gettext import gettext as tr
 
 from holidays.calendars import (
@@ -62,6 +63,25 @@ class Malaysia(
     IslamicHolidays,
     StaticHolidays,
 ):
+    """Malaysia holidays.
+
+    References:
+        * [Holidays Act 1951](https://www.kabinet.gov.my/bkpp/pdf/akta_warta/1951_12_31_act369.pdf)
+        * [Holidays Ordinance (Sabah Cap. 56)](https://sagc.sabah.gov.my/sites/default/files/law/HolidaysOrdinance.pdf)
+        * [Public Holidays Ordinance (Sarawak Cap. 8)](https://www.kabinet.gov.my/bkpp/pdf/akta_warta/sarawak_public_holidays_ord_chapter8.pdf)
+        * [Wikipedia](https://en.wikipedia.org/wiki/Public_holidays_in_Malaysia)
+        * <https://www.nst.com.my/news/nation/2020/03/571660/agongs-birthday-moved-june-6-june-8>
+        * <https://www.nst.com.my/news/nation/2024/02/1014012/melaka-cm-suggests-declaring-feb-20-federal-public-holiday-mark>
+
+    Section 3 of Holidays Act 1951:
+    > If any day specified in the Schedule falls on Sunday then the day following shall be
+    > a public holiday and if such day is already a public holiday, then the day following
+    > shall be a public holiday".
+
+    In Johor (until 1994 and in 2014-2024) and Kedah it's Friday to Sunday,
+    in Kelantan and Terengganu - Saturday to Sunday.
+    """
+
     country = "MY"
     default_language = "ms_MY"
     # %s (estimated).
@@ -125,33 +145,25 @@ class Malaysia(
     supported_languages = ("en_US", "ms_MY", "th")
     start_year = 1952
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        References:
-            - `Holidays Act 1951 <https://www.kabinet.gov.my/bkpp/pdf/akta_warta/1951_12_31_act369.pdf>`_
-            - `Holidays Ordinance (Sabah Cap. 56) <https://sagc.sabah.gov.my/sites/default/files/law/HolidaysOrdinance.pdf>`_
-            - `Public Holidays Ordinance (Sarawak Cap. 8) <https://www.kabinet.gov.my/bkpp/pdf/akta_warta/sarawak_public_holidays_ord_chapter8.pdf>`_
-            - `Wikipedia <https://en.wikipedia.org/wiki/Public_holidays_in_Malaysia>`_
-            - https://www.nst.com.my/news/nation/2020/03/571660/agongs-birthday-moved-june-6-june-8
-            - https://www.nst.com.my/news/nation/2024/02/1014012/melaka-cm-suggests-declaring-feb-20-federal-public-holiday-mark
-
-        Section 3 of Holidays Act 1951:
-        "If any day specified in the Schedule falls on Sunday then the day following shall be
-        a public holiday and if such day is already a public holiday, then the day following
-        shall be a public holiday".
-        In Johor (until 1994 and in 2014-2024) and Kedah it's Friday to Sunday,
-        in Kelantan and Terengganu - Saturday to Sunday.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         BuddhistCalendarHolidays.__init__(self, cls=MalaysiaBuddhistHolidays, show_estimated=True)
         ChineseCalendarHolidays.__init__(self, cls=MalaysiaChineseHolidays, show_estimated=True)
         ChristianHolidays.__init__(self)
         HinduCalendarHolidays.__init__(self, cls=MalaysiaHinduHolidays)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, cls=MalaysiaIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=MalaysiaIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, cls=MalaysiaStaticHolidays)
         kwargs.setdefault("observed_rule", SUN_TO_NEXT_WORKDAY)
         super().__init__(*args, **kwargs)
-        self.dts_observed = set()
+        self.dts_observed: set[date] = set()
 
     def _populate_public_holidays(self):
         # This must be done for every `_populate_public_holidays()` call.

holidays/countries/maldives.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -16,19 +16,26 @@ from holidays.holiday_base import HolidayBase
 
 
 class Maldives(HolidayBase, InternationalHolidays, IslamicHolidays):
-    """
+    """Maldives holidays.
+
     References:
-    - https://en.wikipedia.org/wiki/Public_holidays_in_the_Maldives
-    - https://www.timeanddate.com/holidays/maldives/
-    - http://www.mma.gov.mv/#/about/bankholidays
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_the_Maldives>
+        * <https://www.timeanddate.com/holidays/maldives/>
+        * <http://www.mma.gov.mv/#/about/bankholidays>
     """
 
     country = "MV"
     weekend = {FRI, SAT}
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):