1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
|
# 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 holidays.calendars.chinese import _ChineseLunisolar, CHINESE_CALENDAR
from holidays.calendars.gregorian import APR
from holidays.groups.eastern import EasternCalendarHolidays
class ChineseCalendarHolidays(EasternCalendarHolidays):
"""
Chinese lunisolar calendar holidays.
"""
def __init__(self, cls=None, *, show_estimated=False, calendar=CHINESE_CALENDAR) -> None:
self._chinese_calendar = (
cls(calendar=calendar) if cls else _ChineseLunisolar(calendar=calendar)
)
self._chinese_calendar_show_estimated = show_estimated
@property
def _chinese_new_year(self):
"""
Return Chinese New Year date.
"""
return self._chinese_calendar.lunar_new_year_date(self._year)[0]
@property
def _qingming_festival(self):
"""
Return Qingming Festival (15th day after the Spring Equinox) date.
"""
day = 5
if (self._year % 4 < 1) or (self._year % 4 < 2 and self._year >= 2009):
day = 4
return date(self._year, APR, day)
@property
def _mid_autumn_festival(self):
"""
Return Mid Autumn Festival (15th day of the 8th lunar month) date.
"""
return self._chinese_calendar.mid_autumn_date(self._year)[0]
@property
def _chinese_birthday_of_buddha(self):
"""
Return Add Birthday of the Buddha by Chinese lunar calendar (8th day of the
4th lunar month).
"""
return self._chinese_calendar.buddha_birthday_date(self._year)[0]
@property
def _dragon_boat_festival(self):
"""
Return Dragon Boat Festival (5th day of 5th lunar month) date.
"""
return self._chinese_calendar.dragon_boat_date(self._year)[0]
@property
def _double_ninth_festival(self):
"""
Return Double Ninth Festival (9th day of 9th lunar month) date.
"""
return self._chinese_calendar.double_ninth_date(self._year)[0]
@property
def _dongzhi_festival(self):
"""
Return Dongzhi Festival (Chinese Winter Solstice) date.
"""
return self._chinese_calendar.winter_solstice_date(self._year)[0]
def _add_chinese_calendar_holiday(
self, name: str, dt_estimated: tuple[date | None, bool], days_delta: int = 0
) -> date | None:
"""
Add Chinese calendar holiday.
Adds customizable estimation label to holiday name if holiday date
is an estimation.
"""
return self._add_eastern_calendar_holiday(
name,
dt_estimated,
show_estimated=self._chinese_calendar_show_estimated,
days_delta=days_delta,
)
def _add_chinese_birthday_of_buddha(self, name) -> date | None:
"""
Add Birthday of the Buddha by Chinese lunar calendar (8th day of the
4th lunar month).
Birthday of the Buddha is a Buddhist festival that is celebrated in
most of East Asia and South Asia commemorating the birth of Gautama
Buddha, who was the founder of Buddhism.
https://en.wikipedia.org/wiki/Buddha's_Birthday
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.buddha_birthday_date(self._year)
)
def _add_chinese_day_before_new_years_eve(self, name) -> date | None:
"""
Add day before Chinese New Year's Eve (second to last day of 12th lunar month).
Chinese New Year's Eve is the day before the Chinese New Year.
https://en.wikipedia.org/wiki/Chinese_New_Year's_Eve
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=-2
)
def _add_chinese_new_years_eve(self, name) -> date | None:
"""
Add Chinese New Year's Eve (last day of 12th lunar month).
Chinese New Year's Eve is the day before the Chinese New Year.
https://en.wikipedia.org/wiki/Chinese_New_Year's_Eve
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=-1
)
def _add_chinese_new_years_day(self, name) -> date | None:
"""
Add Chinese New Year's Day (first day of the first lunar month).
Chinese New Year is the festival that celebrates the beginning of
a new year on the traditional lunisolar and solar Chinese calendar.
https://en.wikipedia.org/wiki/Chinese_New_Year
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year)
)
def _add_chinese_new_years_day_two(self, name) -> date | None:
"""
Add Chinese New Year's Day Two.
https://en.wikipedia.org/wiki/Chinese_New_Year
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+1
)
def _add_chinese_new_years_day_three(self, name) -> date | None:
"""
Add Chinese New Year's Day Three.
https://en.wikipedia.org/wiki/Chinese_New_Year
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+2
)
def _add_chinese_new_years_day_four(self, name) -> date | None:
"""
Add Chinese New Year's Day Four.
https://en.wikipedia.org/wiki/Chinese_New_Year
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+3
)
def _add_chinese_new_years_day_five(self, name) -> date | None:
"""
Add Chinese New Year's Day Five.
https://en.wikipedia.org/wiki/Chinese_New_Year
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+4
)
def _add_daeboreum_day(self, name) -> date | None:
"""
Add Daeboreum Day (15th day of 1st lunar month).
Daeboreum is a Korean holiday that celebrates the first full moon
of the new year of the lunar Korean calendar.
https://en.wikipedia.org/wiki/Daeboreum
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+14
)
def _add_dongzhi_festival(self, name) -> date | None:
"""
Add Dongzhi Festival (Chinese Winter Solstice).
The Dongzhi Festival or Winter Solstice Festival is a traditional
Chinese festival celebrated during the Dongzhi solar term
(winter solstice), which falls between December 21 and 23.
https://en.wikipedia.org/wiki/Dongzhi_Festival
"""
return self._add_holiday(name, self._dongzhi_festival)
def _add_hanshi_festival(self, name) -> date | None:
"""
Add Hanshi Festival (105 days after Winter Solstice).
The Cold Food or Hanshi Festival is a traditional Chinese holiday. Its name
derives from the tradition of avoiding the lighting of any kind of fire,
even for the preparation of food.
https://en.wikipedia.org/wiki/Cold_Food_Festival
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.winter_solstice_date(self._year - 1), days_delta=+105
)
def _add_qingming_festival(self, name) -> date:
"""
Add Qingming Festival (15th day after the Spring Equinox).
The Qingming festival or Ching Ming Festival, also known as
Tomb-Sweeping Day in English, is a traditional Chinese festival.
https://en.wikipedia.org/wiki/Qingming_Festival
"""
return self._add_holiday(name, self._qingming_festival)
def _add_double_ninth_festival(self, name) -> date | None:
"""
Add Double Ninth Festival (9th day of 9th lunar month).
The Double Ninth Festival (Chongyang Festival in Mainland China
and Taiwan or Chung Yeung Festival in Hong Kong and Macau).
https://en.wikipedia.org/wiki/Double_Ninth_Festival
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.double_ninth_date(self._year)
)
def _add_dragon_boat_festival(self, name) -> date | None:
"""
Add Dragon Boat Festival (5th day of 5th lunar month).
The Dragon Boat Festival is a traditional Chinese holiday which occurs
on the fifth day of the fifth month of the Chinese calendar.
https://en.wikipedia.org/wiki/Dragon_Boat_Festival
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.dragon_boat_date(self._year)
)
def _add_hung_kings_day(self, name) -> date | None:
"""
Add Hùng Kings' Temple Festival (10th day of the 3rd lunar month).
Vietnamese festival held annually from the 8th to the 11th day of the
3rd lunar month in honour of the Hùng Kings.
https://en.wikipedia.org/wiki/Hùng_Kings'_Festival
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.hung_kings_date(self._year)
)
def _add_mid_autumn_festival(self, name) -> date | None:
"""
Add Mid Autumn Festival (15th day of the 8th lunar month).
The Mid-Autumn Festival, also known as the Moon Festival or
Mooncake Festival.
https://en.wikipedia.org/wiki/Mid-Autumn_Festival
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.mid_autumn_date(self._year)
)
def _add_mid_autumn_festival_day_two(self, name) -> date | None:
"""
Add Mid Autumn Festival Day Two (16th day of the 8th lunar month).
The Mid-Autumn Festival, also known as the Moon Festival or
Mooncake Festival.
https://en.wikipedia.org/wiki/Mid-Autumn_Festival
"""
return self._add_chinese_calendar_holiday(
name, self._chinese_calendar.mid_autumn_date(self._year), days_delta=+1
)
|
