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
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
|
# 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 gettext import gettext as tr
from holidays.calendars.gregorian import FEB, SEP, OCT, DEC
from holidays.constants import GOVERNMENT, OPTIONAL, 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://web.archive.org/web/20250422171106/https://bo.io.gov.mo/bo/i/82/04/declei04.asp)
* [Decreto-Lei n.º 38/87/M](https://web.archive.org/web/20250421204103/https://bo.io.gov.mo/bo/i/87/25/declei38.asp)
* [Decreto-Lei n.º 15/93/M](https://web.archive.org/web/20250421233338/https://bo.io.gov.mo/bo/i/93/17/declei15.asp)
* [Decreto-Lei n.º 7/97/M](https://web.archive.org/web/20250421102457/https://bo.io.gov.mo/bo/i/97/11/declei07.asp)
* [Portaria n.º 85/97/M](https://web.archive.org/web/20250421075645/https://bo.io.gov.mo/bo/i/97/15/port85.asp)
* [Portaria n.º 242/98/M](https://web.archive.org/web/20250421194357/https://bo.io.gov.mo/bo/i/98/48/port242.asp)
* [Regulamento Administrativo n.º 4/1999](https://web.archive.org/web/20250421071204/https://bo.io.gov.mo/bo/i/1999/01/regadm04.asp)
* [Regulamento Administrativo n.º 5/1999](https://web.archive.org/web/20240529183711/https://bo.io.gov.mo/bo/i/1999/01/regadm05.asp)
* [Ordem Executiva n.º 60/2000](https://web.archive.org/web/20250421064911/https://bo.io.gov.mo/bo/i/2000/40/ordem60.asp)
* [Lei n.º 27/2024](https://web.archive.org/web/20250404201226/https://bo.io.gov.mo/bo/i/2025/01/lei27.asp)
Mandatory Holidays References:
* [Decreto-Lei n.º 101/84/M](https://web.archive.org/web/20240518230957/https://bo.io.gov.mo/bo/i/84/35/declei101.asp)
* [Decreto-Lei n.º 24/89/M](https://web.archive.org/web/20241215223116/https://bo.io.gov.mo/bo/i/89/14/declei24.asp)
* [Lei n.º 8/2000](https://web.archive.org/web/20240303230903/https://bo.io.gov.mo/bo/i/2000/19/lei08.asp)
* [Lei n.º 7/2008](https://web.archive.org/web/20250403121227/https://bo.io.gov.mo/bo/i/2008/33/lei07.asp)
Cross-Checking:
* [Public Holidays for 2017-2025](https://web.archive.org/web/20210509143637/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://web.archive.org/web/20250421090753/https://www.dsal.gov.mo/pt/standard/holiday_table.html)
"""
country = "MO"
default_language = "zh_MO"
# %s (estimated).
estimated_label = tr("%s（推定）")
# Decreto-Lei n.º 4/82/M.
start_year = 1982
subdivisions = (
"I", # Ilhas.
"M", # Macau.
)
subdivisions_aliases = {
# Municipalities.
"Concelho das Ilhas": "I",
"海島市": "I",
"海岛市": "I",
"Concelho de Macau": "M",
"澳門市": "M",
"澳门市": "M",
}
supported_categories = (GOVERNMENT, OPTIONAL, PUBLIC)
supported_languages = ("en_MO", "en_US", "pt_MO", "th", "zh_CN", "zh_MO")
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):
"""Macau Mandatory (Statutory) Holidays.
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_optional_holidays(self):
"""Macau General Holidays."""
# 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.
self._add_good_friday(
# Good Friday.
tr("耶穌受難日")
if self._year >= 2000
# Good Friday.
else tr("聖周星期五")
)
# Regulamento Administrativo n.º 4/1999 - Name changed to The Day before Easter.
self._add_holy_saturday(
# The Day before Easter.
tr("復活節前日")
if self._year >= 2000
# Holy Saturday.
else tr("聖周星期六")
)
# 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.
self._add_christmas_day(
# Christmas Day.
tr("聖誕節")
if self._year >= 1999
# Christmas Day.
else tr("聖誕")
)
# 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_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.
tr("%s的補假")
if self._year >= 2020
# The first working day after %s.
else tr("%s後首個工作日")
)
self.observed_estimated_label = (
# Compensatory rest day for %s (estimated).
self.tr("%s的補假（推定）")
if self._year >= 2020
# The first working day after %s (estimated).
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_optional_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_optional_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 General and Government Holidays:
* <https://web.archive.org/web/20240421052702/https://www.io.gov.mo/pt/legis/rec/111020>
Special Mandatory (Statutory) Holidays:
* <https://web.archive.org/web/20250421090753/https://www.dsal.gov.mo/pt/standard/holiday_table.html>
Cross-Checking:
* [Public Holidays for 2017-2025](https://web.archive.org/web/20210509143637/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_public_holidays = {
2015: (SEP, 3, name_70th_war_of_resistance),
}
special_optional_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),
}
|
