非常好用的节假日查询接口

码农天地 - 2021-01-13 11:09:24

概述

平时在开发的过程中经常会用到查询节假日的功能，但由于节假日是每年由国务院统一公布，我们
无法通过计算获取节假日，所以一般需要我们手动来维护节假日。
网上有很多节假日查询的接口，但查询条件和返回结果并不是太理想，
于是就自己写了个节假日查询接口并提供一个简单的页面。接口提供丰富的查询参数并且响应的字段可以自由定制。

快速开始

节假日查询的接口地址为：
https://api.apihubs.cn/holida...
直接访问接口地址会得到当前年份当前月份的整月数据，其中包含了详细的节假日信息
节假日查询的示例页面地址为：
http://www.apihubs.cn/#/holiday
在示例页面中会根据你选择的条件动态生成接口地址，然后可以直接点击浏览器中打开接口地址预览接口返回信息

参数

节假日查询接口提供了丰富的查询参数，所有参数都为可选参数，可灵活搭配使用，多个条件之间为&&的关系
参数中的日期格式均为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，失败时为枚举值中的keymsg 成功时始终为 ok 失败时为枚举值中的valuedata 成功时返回数据，失败时部分返回失败数据，如表单验证失败。

特别申明：本文内容来源网络，版权归原作者所有，如有侵权请立即与我们联系（cy198701067573@163.com），我们将及时处理。