⾮常好⽤的节假⽇查询接⼝（转）
概述
平时在开发的过程中经常会⽤到查询节假⽇的功能，但由于节假⽇是每年由国务院统⼀公布，我们⽆法通过计算获取节假⽇，所以⼀般需要我们⼿动来维护节假⽇。⽹上有很多节假⽇查询的接⼝，但查询条件和返回结果并不是太理想，于是就⾃⼰写了个节假⽇查询接⼝并提供⼀个简单的页⾯。接⼝提供丰富的查询参数并且响应的字段可以⾃由定制。
快速开始
直接访问接⼝地址会得到当前年份当前⽉份的整⽉数据，其中包含了详细的节假⽇信息
天气变冷朋友圈说说参数
节假⽇查询接⼝提供了丰富的查询参数，所有参数都为可选参数，可灵活搭配使⽤，多个条件之间为&&的关系
参数中的⽇期格式均为PHP中的⽇期格式
field ⽤来指定返回结果包含的字段，多个使⽤英⽂逗号分隔枚举
year ⽤来指定要查询的年份，格式为 Y ，多个使⽤英⽂逗号分隔
month ⽤来指定要查询的⽉份，格式为 Ym ，多个使⽤英⽂逗号分隔
date ⽤来指定要查询的⽇期，格式为 Ymd ，多个使⽤英⽂逗号分隔
yearweek ⽤来指定要查询⼀年中的第⼏周，格式为 oW ，多个使⽤英⽂逗号分隔
yearday ⽤来指定要查询⼀年中的第⼏天，格式为 z ，多个使⽤英⽂逗号分隔
holiday ⽤来指定要查询的节假⽇，99为全部节假⽇，多个使⽤英⽂逗号分隔枚举
holiday_overtime ⽤来指定要查询的节假⽇调休（加班），99为全部调休，多个使⽤英⽂逗号分隔枚举
week ⽤来指定要查询的星期，多个使⽤英⽂逗号分隔枚举
workday ⽤来指定查询是否为⼯作⽇（包含调休在内需要上班的⽇⼦）枚举
weekend ⽤来指定查询是否为周末（星期六和星期⽇）枚举
holiday_today ⽤来指定查询是否为节⽇当天枚举
holiday_legal ⽤来指定查询是否为法定节假⽇（三倍⼯资）枚举
holiday_recess ⽤来指定查询是否为假期节假⽇（节⽇是否放假）枚举
lunar ⽤来指定年份、⽉份、⽇期、天数参数是否查询农历⽇期
cn ⽤来指定返回结果是否包含中⽂结果，默认返回的都是数字⽇期和枚举数字有利于逻辑判断不利于显⽰
page 分页页码
size 分页每页数量
唐山地震死多少人响应
节假⽇查询接⼝的枚举功能是基于 php-enum 实现的统⼀格式响应
节假⽇查询接⼝响应始终为JSON数据格式，如下
{
"code": "0",
"msg": "ok",
"data": ""
}
code 成功时始终为0，失败时为枚举值中的key
msg 成功时始终为 ok 失败时为枚举值中的value
回删除的历史记录data 成功时返回数据，失败时部分返回失败数据，如表单验证失败。
data.page 当前页码
data.size 当前每页数量
data.list 节假⽇列表
data.list包含了节假⽇的详细信息，其中的所有字段都可以通过 field 参数进⾏按需使⽤
默认会返回数字⽇期和枚举码，这⾮常适合⽤来做逻辑判断。如下
{
"year": 2021,
"month": 202101,
"date": 20210101,
"yearweek": 202053,
"yearday": 1,
"lunar_year": 2020,
"lunar_month": 202011,
"lunar_date": 20201118,
"lunar_yearday": 343,
"week": 5,
"weekend": 2,
"workday": 2,
"holiday": 22,
"holiday_or": 22,
"holiday_overtime": 10,
"holiday_today": 1,
"holiday_legal": 1,
"holiday_recess": 1
}
当开启了cn查询参数，会将查取的字段名加上 _cn 后缀返回可视化的新，并同原字段⼀起返回。如下
{
"year": 2021,
"month": 202101,
"date": 20210101,
"yearweek": 202053,
"yearday": 1,
"lunar_year": 2020,
"lunar_month": 202011,
"lunar_date": 20201118,
"lunar_yearday": 343,
"week": 5,
"weekend": 2,
"workday": 2,
"holiday": 22,
"holiday_or": 22,
"holiday_overtime": 10,
"holiday_today": 1,
"holiday_legal": 1,
"holiday_recess": 1,
"year_cn": "2021年",
"month_cn": "2021年01⽉",
"date_cn": "2021年01⽉01⽇",
生物必修一知识点
"yearweek_cn": "2020年第53周",
"yearday_cn": "2021年第1天",
"lunar_year_cn": "⼆零⼆零年",
"lunar_month_cn": "⼆零⼆零年冬⽉",
"lunar_date_cn": "⼆零⼆零年冬⽉⼗⼋",
"lunar_yearday_cn": "2020年第343天",
"week_cn": "星期五",
"weekend_cn": "⾮周末",产权证查询
"workday_cn": "⾮⼯作⽇",
"holiday_cn": "元旦",
"holiday_or_cn": "元旦",
2022高考是最难的一年吗
"holiday_overtime_cn": "⾮节假⽇调休",
"holiday_today_cn": "节⽇当天",
"holiday_legal_cn": "法定节假⽇",
"holiday_recess_cn": "假期节假⽇"
}
year 公历年份
month 公历⽉份
date 公历⽇期
yearweek 公历⼀年中的第⼏周，注意这⾥的年份是ISO-8601周编号年份，始终以周⼀⾄周⽇为⼀周。如需获取7天为⼀周直接使⽤年份中的天数除7即可。
yearday 公历⼀年中的第⼏天
lunar_year 农历年份
lunar_month 农历⽉份
lunar_date 农历⽇期
lunar_yearday 农历⼀年中的第⼏天
week 星期⼏
weekend 是否为周末
workday 是否为⼯作⽇（包含调休在内需要上班的⽇⼦）
holiday 节假⽇，这⾥使⽤两位数字枚举表⽰节假⽇，其中特殊数字10表⽰⾮节假⽇，特殊数字99表⽰全部节假⽇
holiday_or 其他节假⽇，枚举与节假⽇相同，表⽰同⼀天中的另⼀个节⽇，如 2020-10-01
holiday_overtime 节假⽇调休，枚举与节假⽇相同
holiday_today 是否为节⽇当天
holiday_legal 是否为法定节假⽇（三倍⼯资）
holiday_recess 是否为假期节假⽇（节⽇是否放假）
节假⽇查询的功能到这⾥就介绍完了，⼤家在使⽤过程中遇到任何问题都可以联系我
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论