# 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 CONTRIBUTORS file) # dr-prodigy (c) 2017-2023 # ryanss (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.gregorian import ( JAN, MAY, JUN, JUL, AUG, SEP, OCT, DEC, SUN, _timedelta, CHRISTMAS, WINTER_SOLSTICE, ) from holidays.constants import OPTIONAL, PUBLIC from holidays.groups import ( ChineseCalendarHolidays, ChristianHolidays, InternationalHolidays, StaticHolidays, ) from holidays.mixins import PreferredDiscretionaryHolidays from holidays.observed_holiday_base import ( ObservedHolidayBase, SAT_SUN_TO_NEXT_WORKDAY, SUN_TO_NEXT_WORKDAY, WORKDAY_TO_NEXT_WORKDAY, ) class HongKong( ObservedHolidayBase, ChineseCalendarHolidays, ChristianHolidays, InternationalHolidays, PreferredDiscretionaryHolidays, StaticHolidays, ): """Hong Kong holidays. References: * [English Wikipedia](https://en.wikipedia.org/wiki/Public_holidays_in_Hong_Kong) * [Chinese Wikipedia](https://zh.wikipedia.org/wiki/香港節日與公眾假期) Statutory Holidays: * [Section 39 of Cap. 57 Employment Ordinance](https://www.elegislation.gov.hk/hk/cap57!en-zh-Hant-HK?INDEX_CS=N&xpid=ID_1438403463460_002) * [Holidays for 2010-2025](https://www.labour.gov.hk/eng/news/holidays_list.htm) General Holidays: * [Cap. 149 General Holidays Ordinance](https://www.elegislation.gov.hk/hk/cap149!en-zh-Hant-HK?INDEX_CS=N) * [Holidays for 2007-2025](https://www.gov.hk/en/about/abouthk/holiday/index.htm) """ country = "HK" default_language = "zh_HK" default_preferred_discretionary_holidays = (CHRISTMAS,) # %s (observed). observed_label = tr("%s（慶祝）") supported_categories = (OPTIONAL, PUBLIC) supported_languages = ("en_HK", "en_US", "th", "zh_CN", "zh_HK") weekend = {SUN} # Current set of holidays actually valid since 1946 start_year = 1946 def __init__(self, *args, **kwargs): ChineseCalendarHolidays.__init__(self) ChristianHolidays.__init__(self) InternationalHolidays.__init__(self) PreferredDiscretionaryHolidays.__init__( self, kwargs.pop("preferred_discretionary_holidays", None) ) StaticHolidays.__init__(self, HongKongStaticHolidays) kwargs.setdefault("observed_rule", SUN_TO_NEXT_WORKDAY) super().__init__(*args, **kwargs) def _add_mid_autumn(self) -> date: # Mid-Autumn Festival. mid_autumn_date = self._mid_autumn_festival if self._year >= 1968: mid_autumn_date = _timedelta(mid_autumn_date, +1) # The Day following Mid-Autumn Festival. name = tr("中秋節翌日") # The Second Day following Mid-Autumn Festival. second_name = tr("中秋節後第二日") else: # Mid-Autumn Festival. name = tr("中秋節") # The Day following Mid-Autumn Festival. second_name = tr("中秋節翌日") if self._is_sunday(mid_autumn_date): if 1983 <= self._year <= 2010: # Mid-Autumn Festival. self._add_holiday(tr("中秋節"), _timedelta(mid_autumn_date, -1)) else: self._add_holiday(second_name, _timedelta(mid_autumn_date, +1)) else: self._add_holiday(name, mid_autumn_date) return mid_autumn_date def _add_lunar_new_year(self, day_three_start_year: int): # Chinese New Year. name = tr("農曆年初一") # Chinese New Year's Eve. preceding_day_lunar = tr("農曆年初一的前一日") # The second day of Chinese New Year. second_day_lunar = tr("農曆年初二") # The third day of Chinese New Year. third_day_lunar = tr("農曆年初三") # The fourth day of Chinese New Year. fourth_day_lunar = tr("農曆年初四") dt_lunar_new_year = self._chinese_new_year if self._year >= 1983: if ( self._is_friday(dt_lunar_new_year) or self._is_saturday(dt_lunar_new_year) or self._is_sunday(dt_lunar_new_year) ): if self._year >= 2012: self._add_chinese_new_years_day_four(fourth_day_lunar) else: self._add_chinese_new_years_eve(preceding_day_lunar) if not self._is_sunday(dt_lunar_new_year): self._add_chinese_new_years_day(name) if not self._is_saturday(dt_lunar_new_year): self._add_chinese_new_years_day_two(second_day_lunar) if not self._is_friday(dt_lunar_new_year): self._add_chinese_new_years_day_three(third_day_lunar) else: self._add_chinese_new_years_day(name) self._add_chinese_new_years_day_two(second_day_lunar) if self._year >= day_three_start_year: self._add_chinese_new_years_day_three(third_day_lunar) def _populate_public_holidays(self): # Statutory Holidays. # Industrial Employment Ordinance implemented in April 1962. if self._year <= 1962: return None if self._year >= 1977: # New Year's Day. self._add_observed(self._add_new_years_day(tr("一月一日"))) self._add_lunar_new_year(day_three_start_year=1977) if self._year >= 2028: # Good Friday. self._add_good_friday(tr("耶穌受難節")) if self._year >= 2030: # The day following Good Friday. self._add_holy_saturday(tr("耶穌受難節翌日")) if self._year >= 2026: # Easter Monday. self._add_easter_monday(tr("復活節星期一")) # Tomb-Sweeping Day. self._add_observed(self._add_qingming_festival(tr("清明節"))) if self._year >= 2022: # The Buddha's Birthday. self._add_observed(self._add_chinese_birthday_of_buddha(tr("佛誕"))) if self._year >= 1999: # Labor Day. self._add_observed(self._add_labor_day(tr("勞動節"))) # Dragon Boat Festival. self._add_observed(self._add_dragon_boat_festival(tr("端午節"))) if self._year >= 1997: # Hong Kong S.A.R. Establishment Day. self._add_observed(self._add_holiday_jul_1(tr("香港特別行政區成立紀念日"))) mid_autumn_date = self._add_mid_autumn() if self._year >= 1977: # Double Ninth Festival. dt_double_ninth = self._add_double_ninth_festival(tr("重陽節")) self._add_observed(dt_double_ninth) if self._year >= 1997: # National Day. name = tr("國慶日") oct_1 = self._add_holiday_oct_1(name) self._add_observed( oct_1, name=name, rule=WORKDAY_TO_NEXT_WORKDAY + SAT_SUN_TO_NEXT_WORKDAY if oct_1 == mid_autumn_date or oct_1 == dt_double_ninth else SUN_TO_NEXT_WORKDAY, ) if WINTER_SOLSTICE in self.preferred_discretionary_holidays: # Winter Solstice. self._add_observed(self._add_dongzhi_festival(tr("冬節"))) if self._year >= 2024: # The first weekday after Christmas Day. self._add_observed(self._add_christmas_day_two(tr("聖誕節後第一個周日"))) if CHRISTMAS in self.preferred_discretionary_holidays: # Christmas Day. self._add_observed(self._add_christmas_day(tr("聖誕節"))) def _populate_optional_holidays(self): # General Holidays. if self._is_sunday(JAN, 1): # The day following New Year's Day. self._add_new_years_day_two(tr("一月一日翌日")) else: # New Year's Day. self._add_new_years_day(tr("一月一日")) self._add_lunar_new_year(day_three_start_year=1968) if self._year >= 1968: dt_qingming = self._qingming_festival if self._is_sunday(dt_qingming) or dt_qingming == _timedelta(self._easter_sunday, +1): # The day following Tomb-Sweeping Day. self._add_holiday(tr("清明節翌日"), _timedelta(dt_qingming, +1)) else: # Tomb-Sweeping Day. self._add_qingming_festival(tr("清明節")) # Good Friday. self._add_good_friday(tr("耶穌受難節")) # The day following Good Friday. self._add_holy_saturday(tr("耶穌受難節翌日")) if self._year >= 1968 and dt_qingming == self._easter_sunday: # The day following Easter Monday. self._add_easter_tuesday(tr("復活節星期一翌日")) else: # Easter Monday. self._add_easter_monday(tr("復活節星期一")) if self._year >= 1999: dt_birthday_of_buddha = self._chinese_birthday_of_buddha if self._is_sunday(dt_birthday_of_buddha): # The day following the Buddha's Birthday. self._add_holiday(tr("佛誕翌日"), _timedelta(dt_birthday_of_buddha, +1)) else: # The Buddha's Birthday. self._add_chinese_birthday_of_buddha(tr("佛誕")) if self._year >= 1999: if self._is_sunday(MAY, 1): # The day following Labor Day. self._add_labor_day_two(tr("勞動節翌日")) else: # Labor Day. self._add_labor_day(tr("勞動節")) if self._year >= 1968: dt_dragon_boat = self._dragon_boat_festival if self._is_sunday(dt_dragon_boat): # The day following Dragon Boat Festival. self._add_holiday(tr("端午節翌日"), _timedelta(dt_dragon_boat, +1)) else: # Dragon Boat Festival. self._add_dragon_boat_festival(tr("端午節")) if self._year >= 1997: if self._is_sunday(JUL, 1): # The day following Hong Kong S.A.R. Establishment Day. self._add_holiday_jul_2(tr("香港特別行政區成立紀念日翌日")) else: # Hong Kong S.A.R. Establishment Day. self._add_holiday_jul_1(tr("香港特別行政區成立紀念日")) mid_autumn_date = self._add_mid_autumn() if self._year >= 1968: dt_double_ninth = self._double_ninth_festival if self._is_sunday(dt_double_ninth): # The day following Double Ninth Festival. self._add_holiday(tr("重陽節翌日"), _timedelta(dt_double_ninth, +1)) else: # Double Ninth Festival. self._add_double_ninth_festival(tr("重陽節")) if self._year >= 1997: dt = date(self._year, OCT, 1) # The day following National Day. name = tr("國慶日翌日") if self._is_sunday(dt) or dt == mid_autumn_date or dt == dt_double_ninth: self._add_holiday(name, self._get_next_workday(dt)) else: # National Day. self._add_holiday_oct_1(tr("國慶日")) if self._year <= 1998: self._add_holiday_oct_2(name) # Christmas Day. name = tr("聖誕節") # The first weekday after Christmas Day. first_after_christmas = tr("聖誕節後第一個周日") # The second weekday after Christmas Day. second_after_christmas = tr("聖誕節後第二個周日") dt_christmas = self._christmas_day if self._is_sunday(dt_christmas): self._add_christmas_day_two(first_after_christmas) self._add_christmas_day_three(second_after_christmas) elif self._is_saturday(dt_christmas): self._add_christmas_day(name) self._add_christmas_day_three(first_after_christmas) else: self._add_christmas_day(name) self._add_christmas_day_two(first_after_christmas) # Previous holidays. if 1952 <= self._year <= 1996: # Queen's Birthday. name = tr("英女皇壽辰") if self._year >= 1983: self._add_holiday_2nd_sat_of_jun(name) self._add_holiday_2_days_past_2nd_sat_of_jun(name) else: if self._year != 1952: self._add_holiday_apr_21(name) else: self._add_holiday_jun_5(name) if self._year <= 1967: # Monday after Pentecost. self._add_whit_monday(tr("靈降臨節後星期一")) # National Day of the Republic of China. self._add_holiday_2nd_mon_of_oct(tr("中華民國國慶日")) # Monday after Remembrance Day. self._add_holiday_1_day_past_2nd_sun_of_nov(tr("和平紀念日後星期一")) if self._year <= 1996: # Anniversary of the liberation of Hong Kong. name = tr("重光紀念日") if self._year >= 1983: self._add_holiday_last_mon_of_aug(name) self._add_holiday_2_days_prior_last_mon_of_aug(name) elif self._year >= 1968: self._add_holiday_1st_mon_of_aug(name) self._add_holiday_last_mon_of_aug(name) else: self._add_holiday_aug_30(name) class HK(HongKong): pass class HKG(HongKong): pass class HongKongStaticHolidays: # Wedding of Prince Charles and Diana. wedding_of_charles_and_diana = tr("英國王儲查理斯王子與戴安娜婚禮") # Second day of Queen Elizabeth II and her husband's visit to Hong Kong. queen_visit_hk = tr("英女王伊利沙伯二世伉儷訪港的第二天") # Queen's Birthday. queen_birthday = tr("英女皇壽辰") # The day following Hong Kong S.A.R. Establishment Day. day_following_hksar_establishment_day = tr("香港特別行政區成立紀念日翌日") # 70th Anniversary of the Victory of the Chinese People's War of Resistance against # Japanese Aggression and the World Anti-Fascist War. victory_70th_anniversary = tr("中國人民抗日戰爭勝利70周年紀念日") # Sino-Japanese War Victory Day. war_victory_day = tr("抗日戰爭勝利紀念日") # The day following National Day. day_following_national_day = tr("國慶日翌日") # Additional public holiday. additional_public_holiday = tr("額外公眾假期") special_public_holidays = { 1981: (JUL, 29, wedding_of_charles_and_diana), 1986: (OCT, 22, queen_visit_hk), 1997: (JUL, 2, day_following_hksar_establishment_day), 2015: (SEP, 3, victory_70th_anniversary), } special_optional_holidays = { 1981: (JUL, 29, wedding_of_charles_and_diana), 1986: (OCT, 22, queen_visit_hk), 1997: ( (JUN, 28, queen_birthday), (JUN, 30, queen_birthday), (JUL, 2, day_following_hksar_establishment_day), (AUG, 18, war_victory_day), (OCT, 2, day_following_national_day), ), 1998: ( (AUG, 17, war_victory_day), (OCT, 2, day_following_national_day), ), 1999: (DEC, 31, additional_public_holiday), 2015: (SEP, 3, victory_70th_anniversary), }