ilgaz/Time-Series-Analysis
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

some new features

Browse Source
This commit is contained in:
ilgazca
2025-07-30 18:53:50 +03:00
parent 8019bd3b7c
commit 079804a0fc
2118 changed files with 297840 additions and 502 deletions
Download Patch File Download Diff File Expand all files Collapse all files

431
.venv/lib/python3.12/site-packages/holidays/countries/hongkong.py Normal file
View File

@ -0,0 +1,431 @@
# 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 <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.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.preferred_discretionary_holidays 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](http://archive.today/2025.04.29-125537/https://www.elegislation.gov.hk/hk/cap57!en-zh-Hant-HK?INDEX_CS=N&xpid=ID_1438403463460_002)
* [Holidays for 2010-2025](https://web.archive.org/web/20250402133857/https://www.labour.gov.hk/eng/news/holidays_list.htm)
General Holidays:
* [Cap. 149 General Holidays Ordinance](http://archive.today/2025.04.29-125900/https://www.elegislation.gov.hk/hk/cap149!en-zh-Hant-HK?INDEX_CS=N)
* [Holidays for 2007-2025](https://web.archive.org/web/20250116080351/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),
}