holidays.countries.malaysia

Malaysia(*args, islamic_show_estimated=True, **kwargs)

Bases: ObservedHolidayBase, BuddhistCalendarHolidays, ChineseCalendarHolidays, ChristianHolidays, HinduCalendarHolidays, InternationalHolidays, IslamicHolidays, StaticHolidays

Malaysia holidays.

References
Subdivisions Holidays References

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.

Parameters:
  • islamic_show_estimated (bool, default: True ) –

    Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.

country = 'MY' class-attribute instance-attribute

default_language = 'ms_MY' class-attribute instance-attribute

estimated_label = tr('%s (anggaran)') class-attribute instance-attribute

observed_label = tr('Cuti %s') class-attribute instance-attribute

observed_estimated_label = tr('Cuti %s (anggaran)') class-attribute instance-attribute

start_year = 1952 class-attribute instance-attribute

subdivisions = ('01', '02', '03', '04', '05', '06', '07', '08', '09', '10', '11', '12', '13', '14', '15', '16') class-attribute instance-attribute

subdivisions_aliases = {'Johor': '01', 'JHR': '01', 'Kedah': '02', 'KDH': '02', 'Kelantan': '03', 'KTN': '03', 'Melaka': '04', 'MLK': '04', 'Negeri Sembilan': '05', 'NSN': '05', 'Pahang': '06', 'PHG': '06', 'Pulau Pinang': '07', 'PNG': '07', 'Perak': '08', 'PRK': '08', 'Perlis': '09', 'PLS': '09', 'Selangor': '10', 'SGR': '10', 'Terengganu': '11', 'TRG': '11', 'Sabah': '12', 'SBH': '12', 'Sarawak': '13', 'SWK': '13', 'Wilayah Persekutuan Kuala Lumpur': '14', 'KUL': '14', 'Wilayah Persekutuan Labuan': '15', 'LBN': '15', 'Wilayah Persekutuan Putrajaya': '16', 'PJY': '16'} class-attribute instance-attribute

supported_languages = ('en_US', 'ms_MY', 'th') class-attribute instance-attribute

MY(*args, islamic_show_estimated=True, **kwargs)

Bases: Malaysia

Parameters:
  • islamic_show_estimated (bool, default: True ) –

    Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.

MYS(*args, islamic_show_estimated=True, **kwargs)

Bases: Malaysia

Parameters:
  • islamic_show_estimated (bool, default: True ) –

    Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.

MalaysiaBuddhistHolidays

Bases: _CustomBuddhistHolidays

VESAK_MAY_DATES = {2001: (MAY, 7), 2002: (MAY, 27), 2003: (MAY, 15), 2004: (MAY, 3), 2005: (MAY, 22), 2006: (MAY, 12), 2007: (MAY, 1), 2008: (MAY, 19), 2009: (MAY, 9), 2010: (MAY, 28), 2011: (MAY, 17), 2012: (MAY, 5), 2013: (MAY, 24), 2014: (MAY, 13), 2015: (MAY, 3), 2016: (MAY, 21), 2017: (MAY, 10), 2018: (MAY, 29), 2019: (MAY, 19), 2020: (MAY, 7), 2021: (MAY, 26), 2022: (MAY, 15), 2023: (MAY, 4), 2024: (MAY, 22), 2025: (MAY, 12), 2026: (MAY, 31)} class-attribute instance-attribute

MalaysiaChineseHolidays(calendar=CHINESE_CALENDAR)

Bases: _CustomChineseHolidays

LUNAR_NEW_YEAR_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

MalaysiaHinduHolidays

Bases: _CustomHinduHolidays

DIWALI_DATES = {2001: (NOV, 14), 2002: (NOV, 3), 2003: (OCT, 23), 2004: (NOV, 11), 2005: (NOV, 1), 2006: (OCT, 21), 2007: (NOV, 8), 2008: (OCT, 27), 2009: (OCT, 17), 2010: (NOV, 5), 2011: (OCT, 26), 2012: (NOV, 13), 2013: (NOV, 2), 2014: (OCT, 22), 2015: (NOV, 10), 2016: (OCT, 29), 2017: (OCT, 18), 2018: (NOV, 6), 2019: (OCT, 27), 2020: (NOV, 14), 2021: (NOV, 4), 2022: (OCT, 24), 2023: (NOV, 12), 2024: (OCT, 31), 2025: (OCT, 20), 2026: (NOV, 8)} class-attribute instance-attribute

THAIPUSAM_DATES = {2018: (JAN, 31), 2019: (JAN, 21), 2020: (FEB, 8), 2021: (JAN, 28), 2022: (JAN, 18), 2023: (FEB, 5), 2024: (JAN, 25), 2025: (FEB, 11), 2026: (FEB, 1), 2027: (JAN, 22)} class-attribute instance-attribute

MalaysiaIslamicHolidays(calendar_delta_days=0)

Bases: _CustomIslamicHolidays

Parameters:
  • calendar_delta_days (int, default: 0 ) –

    Number of days to shift all calculated holiday dates. Positive values move holidays forward, negative values move them backward. Defaults to 0 (no shift).

EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

EID_AL_ADHA_DATES = {2001: (MAR, 6), 2002: (FEB, 23), 2003: (FEB, 12), 2004: (FEB, 2), 2008: (DEC, 9), 2009: (NOV, 28), 2010: (NOV, 17), 2011: (NOV, 7), 2014: (OCT, 5), 2015: (SEP, 24), 2016: (SEP, 12), 2018: (AUG, 22), 2022: (JUL, 10), 2023: (JUN, 29), 2024: (JUN, 17), 2025: (JUN, 7)} class-attribute instance-attribute

EID_AL_FITR_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

EID_AL_FITR_DATES = {2001: (DEC, 17), 2002: (DEC, 6), 2003: (NOV, 26), 2006: (OCT, 24), 2011: (AUG, 31), 2019: (JUN, 5), 2023: (APR, 22), 2025: (MAR, 31), 2026: (MAR, 21)} class-attribute instance-attribute

HARI_HOL_JOHOR_DATES_CONFIRMED_YEARS = (2011, 2026) class-attribute instance-attribute

HARI_HOL_JOHOR_DATES = {2011: (JAN, 12), 2012: (DEC, 20), 2013: (DEC, 10), 2014: (NOV, 29), 2015: (NOV, 19), 2016: (NOV, 7), 2017: (OCT, 27), 2020: (SEP, 24), 2022: (SEP, 3), 2023: (AUG, 23), 2024: (AUG, 11), 2026: (JUL, 21)} class-attribute instance-attribute

HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

HIJRI_NEW_YEAR_DATES = {2003: (MAR, 5), 2004: (FEB, 22), 2010: (DEC, 8), 2011: (NOV, 27), 2013: (NOV, 5), 2017: (SEP, 22), 2019: (SEP, 1), 2021: (AUG, 10), 2025: (JUN, 27), 2026: (JUN, 17)} class-attribute instance-attribute

ISRA_AND_MIRAJ_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

ISRA_AND_MIRAJ_DATES = {2001: (OCT, 15), 2006: (AUG, 22), 2007: (AUG, 11), 2008: (JUL, 31), 2014: (MAY, 27), 2016: (MAY, 5), 2018: (APR, 14), 2022: (MAR, 1), 2026: (JAN, 17)} class-attribute instance-attribute

MAWLID_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

MAWLID_DATES = {2003: (MAY, 14), 2004: (MAY, 2), 2006: (APR, 11), 2011: (FEB, 16), 2012: (FEB, 5), 2014: (JAN, 14), 2015: ((JAN, 3), (DEC, 24)), 2016: (DEC, 12), 2017: (DEC, 1), 2021: (OCT, 19), 2022: (OCT, 10), 2023: (SEP, 28), 2024: (SEP, 16), 2025: (SEP, 5)} class-attribute instance-attribute

NUZUL_AL_QURAN_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

NUZUL_AL_QURAN_DATES = {2001: (DEC, 3), 2003: (NOV, 12), 2004: (NOV, 1), 2005: (OCT, 21), 2008: (SEP, 18), 2014: (JUL, 15), 2018: (JUN, 2), 2022: (APR, 19), 2024: (MAR, 28), 2025: (MAR, 18), 2026: (MAR, 7)} class-attribute instance-attribute

RAMADAN_BEGINNING_DATES_CONFIRMED_YEARS = (2001, 2026) class-attribute instance-attribute

RAMADAN_BEGINNING_DATES = {2001: (NOV, 17), 2003: (OCT, 27), 2004: (OCT, 16), 2005: (OCT, 5), 2008: (SEP, 2), 2014: (JUN, 29), 2016: (JUN, 7), 2018: (MAY, 17), 2022: (APR, 3), 2024: (MAR, 12), 2025: (MAR, 2), 2026: (FEB, 19)} class-attribute instance-attribute

MalaysiaStaticHolidays

general_election_additional_holiday = tr('Cuti Peristiwa (pilihan raya umum)') class-attribute instance-attribute

additional_holiday = tr('Cuti Peristiwa') class-attribute instance-attribute

eid_al_adha = tr('Hari Raya Qurban') class-attribute instance-attribute

labor_day = tr('Hari Pekerja') class-attribute instance-attribute

malaysia_cup_holiday = tr('Cuti Piala Malaysia') class-attribute instance-attribute

special_public_holidays = {1999: (NOV, 29, general_election_additional_holiday), 2017: ((APR, 24, tr('Hari Pertabalan Yang di-Pertuan Agong ke-15')), (SEP, 4, tr('Cuti tambahan sempena memperingati SAT 2017'))), 2018: (MAY, 9, general_election_additional_holiday), 2019: (JUL, 30, tr('Hari Pertabalan Yang di-Pertuan Agong ke-16')), 2022: ((NOV, 18, general_election_additional_holiday), (NOV, 19, general_election_additional_holiday), (NOV, 28, additional_holiday)), 2023: (APR, 21, tr('Hari Raya Puasa (pergantian hari)')), 2025: (SEP, 15, additional_holiday)} class-attribute instance-attribute

special_01_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 13, additional_holiday))} class-attribute instance-attribute

special_01_public_holidays_observed = {2022: (MAY, 4, labor_day)} class-attribute instance-attribute

special_02_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 13, additional_holiday))} class-attribute instance-attribute

special_02_public_holidays_observed = {2022: (MAY, 4, labor_day)} class-attribute instance-attribute

special_03_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 13, additional_holiday))} class-attribute instance-attribute

special_03_public_holidays_observed = {2022: (MAY, 4, labor_day)} class-attribute instance-attribute

special_04_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_04_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_05_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_05_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_06_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_06_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_07_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_07_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_08_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_08_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_09_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_09_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_10_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday))} class-attribute instance-attribute

special_10_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_11_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 13, additional_holiday))} class-attribute instance-attribute

special_11_public_holidays_observed = {2007: (JAN, 2, tr('Hari Arafah')), 2022: (MAY, 4, labor_day)} class-attribute instance-attribute

special_12_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_13_public_holidays = {2018: ((MAY, 17, additional_holiday), (MAY, 18, additional_holiday))} class-attribute instance-attribute

special_13_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_14_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday)), 2021: (DEC, 3, malaysia_cup_holiday)} class-attribute instance-attribute

special_14_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_15_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday)), 2021: (DEC, 3, malaysia_cup_holiday)} class-attribute instance-attribute

special_15_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute

special_16_public_holidays = {2018: ((MAY, 10, additional_holiday), (MAY, 11, additional_holiday)), 2021: (DEC, 3, malaysia_cup_holiday)} class-attribute instance-attribute

special_16_public_holidays_observed = {2007: (JAN, 2, eid_al_adha)} class-attribute instance-attribute