节假日

一个用于快速高效生成指定国家和行政区(如州或省)政府指定节假日集合的Python库。它旨在尽可能快速和灵活地确定某个特定日期是否是节假日。

安装

可通过pip安装或更新最新的稳定版本:

$ pip install --upgrade holidays

也可直接从GitHub安装最新开发版:

$ pip install --upgrade https://github.com/vacanza/python-holidays/tarball/dev

所有新功能都会先推送到dev分支,然后在官方版本升级时发布到main分支。

文档

可查看Read the Docs上的文档。

快速上手

from datetime import date import holidays

us_holidays = holidays.US() # 这是一个类似字典的对象 us_holidays = holidays.country_holidays('US') # 同上,但输入的是字符串

nyse_holidays = holidays.NYSE() # 这也是一个类似字典的对象 nyse_holidays = holidays.financial_holidays('NYSE') # 同上,但输入的是字符串

date(2015, 1, 1) in us_holidays # True date(2015, 1, 2) in us_holidays # False us_holidays.get('2014-01-01') # "New Year's Day"

HolidayBase类还可以识别日期字符串和Unix时间戳:

'2014-01-01' in us_holidays # True '1/1/2014' in us_holidays # True 1388597445 in us_holidays # True

某些节假日可能只在某个国家的某些地区有效:

us_pr_holidays = holidays.country_holidays('US', subdiv='PR') '2018-01-06' in us_holidays # False '2018-01-06' in us_pr_holidays # True

更多示例和详细信息,请参阅python-holidays文档。

支持的国家

目前支持150个国家代码。标准的国家代码使用ISO 3166-1 alpha-2代码,行政区使用ISO 3166-2代码。某些国家有常见名称或外文名称的别名。

每个国家/地区都有一个默认语言,用作备用语言。支持的语言使用ISO 639-1或639-2代码表示。

除了常规(全国性)节假日,许多国家还有其他类型的假期,如银行假日、学校假期、额外(带薪或无薪)假期、公务员假期、宗教假期等。支持的假期类型在supported_categories属性中定义。这是一份从英语到中文的翻译,请提供以下源文本的中文翻译:

- 国家

代码
行政区划
支持的语言
支持的类别

- 阿尔巴尼亚

- 阿尔及利亚

DZ
ar, en_US, fr

- 美属萨摩亚

AS
可以作为美国的一个州来加载
非官方

- 安道尔

AD
教区: 02, 03, 04, 05, 06, 07, 08

- 安哥拉

AO
en_US, pt_AO, uk

- 阿根廷

AR
en_US, es, uk

- 亚美尼亚

AM
en_US, hy

- 阿鲁巴

AW
en_US, nl, pap_AW, uk

- 澳大利亚

AU
州和直辖区: ACT (澳大利亚首都领地), NSW (新南威尔士州), NT (北部领地), QLD (昆士兰州), SA (南澳大利亚州), TAS (塔斯马尼亚州), VIC (维多利亚州), WA (西澳大利亚州)
银行, 半天

- 奥地利

AT
州: 1 (布尔根兰德州, Bgld, B), 2 (卡林西亚州, Ktn, K), 3 (下奥地利州, NÖ, N), 4 (上奥地利州, OÖ, O), 5 (萨尔茨堡州, Sbg, S), 6 (施蒂利亚州, Stmk, St), 7 (蒂罗尔州, T), 8 (福拉尔贝格州, Vbg, V), 9 (维也纳, W)
de, en_US, uk
银行

- 阿塞拜疆

AZ
az, en_US, uk
工作日

- 巴哈马

- 巴林

BH
ar, en_US

- 孟加拉国

- 巴巴多斯

- 白俄罗斯

BY
be, en_US

- 比利时

BE
de, en_US, fr, nl, uk
银行

- 伯利兹

- 玻利维亚

BO
省份: B, C, H, L, N, O, P, S, T
en_US, es, uk

- 波斯尼亚和黑塞哥维那

BA
实体和地区: BIH, BRC, SRP
bs, en_US, sr, uk

- 博茨瓦纳

- 巴西

BR
州: AC, AL, AM, AP, BA, CE, DF, ES, GO, MA, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO
可选

- 文莱

BN
en_US, ms, th

- 保加利亚

BG
bg, en_US, uk
学校

- 布基纳法索

- 布隆迪

- 柬埔寨

KH
en_US, km, th

- 喀麦隆

- 加拿大

CA
省和地区: AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT
ar, en_CA, en_US, fr, th
政府, 可选

- 乍得

- 智利

CL
大区: AI, AN, AP, AR, AT, BI, CO, LI, LL, LR, MA, ML, NB, RM, TA, VS
en_US, es, uk
银行

- 中国

CN
en_US, th, zh_CN, zh_TW
半天

- 哥伦比亚

CO
en_US, es, uk

- 哥斯达黎加

CR
en_US, es, uk
可选

- 克罗地亚

HR
en_US, hr, uk

- 古巴

CU
en_US, es, uk

- 库拉索

CW
en_US, nl, pap_CW, uk

- 塞浦路斯

CY
el, en_CY, en_US, uk
银行, 可选

- 捷克

CZ
cs, en_US, sk, uk

- 丹麦

DK
da, en_US, uk
可选

- 吉布提

DJ
ar, en_US, fr

- 多米尼加共和国

DO
en_US, es, uk

- 厄瓜多尔

EC
en_US, es, uk

- 埃及

EG
ar, en_US

- 萨尔瓦多

SV
省份: AH, CA, CH, CU, LI, MO, PA, SA, SM, SO, SS, SV, UN, US

- 爱沙尼亚

EE
en_US, et, uk

- 斯威士兰

- 埃塞俄比亚

ET
am, ar, en_US

- 芬兰

FI
en_US, fi, sv_FI, uk
非官方

- 法国

FR
省: BL, GES, GP, GY, MF, MQ, NC, PF, RE, WF, YT
en_US, fr, uk

- 加蓬

- 格鲁吉亚

GE
en_US, ka, uk
政府

- 德国

DE
州: BB, BE, BW, BY, BYP, HB, HE, HH, MV, NI, NW, RP, SH, SL, SN, ST, TH
de, en_US, uk

- 加纳

- 希腊

GR
el, en_US, uk
半天

- 格陵兰

GL
da, en_US, kl
可选

- 关岛

GU
可以作为美国的一个州来加载
非官方

- 危地马拉

GT
en_US, es

- 洪都拉斯

HN
en_US, es, uk

- 香港香港匈牙利冰岛印度安达曼尼科巴群岛（AN）、安得拉邦（AP）、阿鲁纳恰尔邦（AR）、阿萨姆邦（AS）、比哈尔邦（BR）、恰蒂斯加尔邦（CG）、昌迪加尔（CH）、达德拉和纳格尔哈维利（DH）、德里（DL）、果阿邦（GA）、古吉拉特邦（GJ）、喜马偕尔邦（HP）、哈里亚纳邦（HR）、贾坎德邦（JH）、查谟和克什米尔邦（JK）、卡纳塔卡邦（KA）、喀拉拉邦（KL）、拉达克（LA）、拉克沙群岛（LD）、马哈拉施特拉邦（MH）、美利亚拉姆邦（ML）、曼尼普尔邦（MN）、中央邦（MP）、米佐拉姆邦（MZ）、那格浦尔（NL）、奥迪沙邦（OD）、旁遮普邦（PB）、本地居治（PY）、拉贾斯坦邦（RJ）、锡金（SK）、泰米尔纳德邦（TN）、苏王邦（TR）、特朗盖纳邦（TS）、乌塔拉坎德（UK）、北方邦（UP）、西孟加拉邦（WB）

印度尼西亚

伊朗

爱尔兰

马恩岛

以色列希伯来语

意大利阿格里真托省（AG）、亚历山德里亚省（AL）、安科纳省（AN）、阿奥斯塔省（AO）、阿斯科利皮切诺省（AP）、L'阿奎拉省（AQ）、阿雷佐省（AR）、亚蒂省（AT）、阿维利诺省（AV）、巴里省（BA）、贝尔加莫省（BG）、比拉省（BI）、贝卢诺省（BL）、贝内文托省（BN）、博洛尼亚省（BO）、布雷西亚省（BR）、布恩索尼科省（BS）、巴特勒省（BT）、波尔扎诺省（BZ）、卡利亚里省（CA）、康帕尼亚省（CB）、卡塞塔省（CE）、奇耶蒂省（CH）、卡塔尼亚省（CL）、科摩省（CO）、克雷莫纳省（CR）、科森扎省（CS）、卡塔尼亚省（CT）、卡塔尼亚省（CZ）、恩纳省（EN）、费尔莫-卡罗科 (FC)、费拉拉省（FE）、福贾省（FG）、佛罗伦萨省（FI）、费尔莫省（FM）、弗罗西诺内省（FR）、热那亚省（GE）、戈里齐亚省（GO）、格罗塞托省（GR）、翁比亚省（IM）、伊色尼亚省（IS）、克罗托内省（KR）、拉奎拉省（LC）、莱切省（LE）、利沃诺省（LI）、罗迪省（LO）、拉提纳省（LT）、卢卡省（LU）、马萨卡拉省（MB）、梅拉诺省（MC）、美斯特拉省（ME）、米兰省（MI）、蒙特纳省（MN）、摩德纳省（MO）、马泰拉省（MS）、马泰拉省（MT）、那不勒斯省（NA）、诺瓦拉省（NO）、努奥罗省（NU）、奥里斯塔诺省（OR）、帕尔马省（PA）、佩萨罗-乌尔比诺省（PC）、帕多瓦省（PD）、佩鲁贾省（PE）、皮亚琴察省（PG）、皮萨省（PI）、彭特雷莫利省（PN）、波特诺瓦省（PO）、帕尔马省（PR）、特伦托省（PT）、佩鲁贾省（PU）、帕维亚省（PV）、波滕察省（PZ）、拉文纳省（RA）、卡拉布里亚科森扎省（RC）、雷焦艾米利亚省（RE）、拉古萨省（RG）、里米尼省（RI）、罗马省（RM）、罗马尼亚（RN）、罗维戈省（RO）、萨莱诺省（SA）、锡耶纳省（SI）、索伦托省（SO）、拉斯佩齐亚省（SP）、锡拉库扎省（SR）、萨萨里省（SS）、苏尔钦托省（SU）、萨沃纳省（SV）、塔兰托省（TA）、特拉尼省（TE）、特尼省（TN）、都灵省（TO）、特拉帕尼省（TP）、特里卡里科省（TR）、特里耶斯特省（TS）、特维泽省（TV）、乌迪内省（UD）、瓦雷泽省（VA）、维埃拉比利纳省（VB）、韦尼尼亚省（VC）、威尼斯省（VE）、维琴察省（VI）、韦罗纳省（VR）、维泰博省（VT）、维埃纳省（VV）。城市：安德里亚、巴尔莱塔、切塞纳、福尔利、佩萨罗、特拉尼、乌尔比诺

日本日语、泰语

约旦阿拉伯语、英语

哈萨克斯坦

肯尼亚

科威特阿拉伯语、英语

吉尔吉斯斯坦

老挝英语、老挝语、泰语银行、学校、工作日

拉脱维亚

莱索托

列支敦士登德语、英语、英国腔

立陶宛

卢森堡德语、英语、法语、卢森堡语、英国腔

马达加斯加

马拉维

马来西亚柔佛（01）、吉打（02）、吉兰丹（03）、马六甲（04）、森美兰（05）、彭亨（06）、檳城（07）、霹雳（08）、玻璃市（09）、雪兰莪（10）、登武里（11）、沙巴（12）、砂劳越（13）、吉隆坡联邦直辖区（14）、纳闽联邦直辖区（15）、普特拉再也联邦直辖区（16）英语、马来语（马来西亚）

马尔代夫

马耳他英语、马耳他语

马绍尔群岛

毛里塔尼亚

墨西哥英语、西班牙语、英国腔

摩尔多瓦英语、罗马尼亚语、英国腔

摩纳哥英语、法语、英国腔

黑山

摩洛哥阿拉伯语、英语、法语

莫桑比克英语、葡萄牙语（莫桑比克）、英国腔

纳米比亚

荷兰英语、荷兰语、英国腔可选

新西兰奥克兰（AUK）、湾区（BOP）、坎特伯雷（CAN）、基督城（CIT）、吉斯伯恩（GIS）、哈威百克（HKB）、马尔堡（MBH）、曼瓦图（MWT）、纳尔逊（NSN）、诺森兰（NTL）、奥塔哥（OTA）、塔拉拉克（STL）、塔斯曼尼亚（TAS）、塔拉基（TKI）、惠灵顿（WGN）、瓦卡蒂普（WKO）、西海岸（WTC）

尼加拉瓜安德烈斯（AN）、阿苏尔（AS）、博阿斯（BO）、卡拉索（CA）、奇南德加（CI）、科尔特斯（CO）、埃斯特利（ES）、格拉纳达（GR）、吉诺特加（JI）、莱昂（LE）、马德里斯（MD）、门地兹堡（MN）、马萨亚（MS）、马塔加尔帕（MT）、努埃瓦塞戈维亚（NS）、里瓦斯（RI）、圣胡安（SJ）英语、西班牙语、英国腔

尼日利亚

北马里亚纳群岛可作为美国的附属领土加载

北马其顿

挪威英语、挪威语、英国腔

巴基斯坦

帕劳武装部队、半天工作制

巴拿马

巴布亚新几内亚

巴拉圭政府英语、西班牙语、英国腔

秘鲁英语、西班牙语、英国腔

菲律宾

波兰英语、波兰语、英国腔

葡萄牙 1号（01）、2号（02）、3号（03）、4号（04）、5号（05）、6号（06）、7号（07）、8号（08）、9号（09）、10号（10）、11号（11）、12号（12）、13号（13）、14号（14）、15号（15）、16号（16）、17号（17）、18号（18）、20号（20）、30号（30）英语、葡萄牙语（葡萄牙）、英国腔可选

波多黎各可作为美国的附属领土加载非官方

罗马尼亚英语、罗马尼亚语、英国腔

俄罗斯英语、俄语

萨摩亚