获取中国法定节假日的封装
背景
之前有写过一个定时任务的项目,主要是在工作日进行一些数据推送和任务提醒。为了精确的判断当天是否为工作日(这里包含了正常上班日和法定节假日的补班),在网上看到了一个api,用下来也挺稳定的。但是本人喜欢折腾,并且依赖别人的api总归不可靠,所以抽时间写了这个工具,也算是重复造了个轮子吧,大家有需要的可以拿去用,目前已经发布到pypi,可以直接通过pip安装
工具说明
名称
get_holiday_cn
获取中国法定节假日
支持的python版本
python3.x
功能点
- 传入日期获取中国法定节假日
依赖说明
依赖NateScarlet/holiday-cn
安装
pip install get_holiday_cn
数据说明
{
"code": 0, // 0服务正常。-1服务出错
"type": {
"type": enum(0, 1, 2, 3), // 节假日类型,分别表示 工作日、周末、节日、调休。
"name": "周六", // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
"week": enum(1 - 7) // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
"status": enum(0, 1) // 数据场景类型,0来源于仓库中或者正常的上班日,数据可靠;1表示当前传入日期在仓库中未查询到,直接走系统计算,数据不可靠。
},
"holiday": { // 只有当type为2,3时,该对象才存在
"holiday": false, // true表示是节假日,false表示是调休
"name": "国庆节调休", // 节假日的中文名。如果是调休,则是调休的中文名,例如"国庆节调休"
"date": "2021-10-09" // 当前请求的日期
}
}
使用
from get_holiday_cn.client import getHoliday
client = getHoliday()
# 获取今日数据
print(client.assemble_holiday_data())
# 指定日期获取数据
print(client.assemble_holiday_data(today="2021-10-01"))
Github地址
https://github.com/longweiqiang/get_holiday_cn