概述

平时在开发的过程中经常会用到查询节假日的功能，但由于节假日是每年由国务院统一公布，我们
无法通过计算获取节假日，所以一般需要我们手动来维护节假日。

网上有很多节假日查询的接口，但查询条件和返回结果并不是太理想，
于是就自己写了个节假日查询接口并提供一个简单的页面。接口提供丰富的查询参数并且响应的字段可以自由定制。

快速开始

节假日查询的接口地址为：

https://api.apihubs.cn/holiday/get

直接访问接口地址会得到当前年份当前月份的整月数据，其中包含了详细的节假日信息

节假日查询的示例页面地址为：

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，失败时为枚举值中的key
msg 成功时始终为 ok 失败时为枚举值中的value
data 成功时返回数据，失败时部分返回失败数据，如表单验证失败。
data.page 当前页码
data.size 当前每页数量
data.total 根据查询条件查到的总数量
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": "元旦","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 是否为假期节假日（节日是否放假）

节假日查询的功能到这里就介绍完了，大家在使用过程中遇到任何问题都可以联系我

非常好用的节假日查询接口相关推荐

mysql2013年8月怎么打出来_2020年8月31日，上周完成了一个查询接口来检查mysql的数据，速度很慢,20200831,从,MySQL,中查,贼...
2020-08-31 上周完成一个查询接口,从MySQL中查数据,速度贼慢, 原因是数据5000万+,所以真正接触优化的机会来了,所以决定好好研究一下,做一个记录. 事情是这样的,mysql表中只有两 ...
怎样调用php的足球联赛接口,足球赛事查询接口调用文档
足球赛事查询接口,目前支持英超,西甲,德甲,意甲,法甲,中超等赛事接口平台:api 接口地址:http://op.juhe.cn/onebox/football/combat 支持格式:json/ ...
快递物流查询接口介绍
快递查询接口是指快递查询网对外开放的应用程序接口,开发人员能够通过调用该接口与快递查询网进行交互,并基于该接口开发自己的快递查询应用程序.目前比较常用的接口有快递鸟.快递100.快递网等. 应用场景 ...
python调用api应用接口_第三方免费快递物流查询接口平台（快递鸟）api接口调用...
随着网购的发展,快递业也随之壮大.快递查询接口对接的需求量也越来越大,下面是对免费快递接口做的整理,并附上调用流程,分享给大家. 项目开发中,有些需求难免会用到关于快递的一些Api接口:本篇主要介绍的 ...
boot spring 接口接收数据_在 Spring Boot 中使用 Dataway 配置数据查询接口
Dataway介绍 Dataway 是基于 DataQL 服务聚合能力,为应用提供的一个接口配置工具.使得使用者无需开发任何代码就配置一个满足需求的接口. 整个接口配置.测试.冒烟.发布.一站式都通过 ...
php 支付宝订单查询_5. PHP接入支付宝单笔订单查询接口
巴西奥运会来了,刚好我又是做体育行业的互联网.哎!这个月又要加班成狗了.最近遇到好多莫名其妙的问题,待我忙完这段,再跟大家分享下.今天还是继续说说 Payment项目今天主要说说支付宝订单查询接口. ...
快春运了，做个火车余票查询接口，余票来源12306，图是百度地图
摘要:做个火车票查询余票接口,数据来源于12306,地图使用百度地图(未完成) 今天本来想查询一下回家的车票,结果坑爹的发现12306网站死活打不开,尼玛真实坑爹,想查询一下余票都怎么难于是自己决定 ...
手机型号云服务器,手机型号查询接口
手机型号查询接口内容精选换一换通过调用云手机服务提供的接口,您可以完整地使用云手机的所有功能.例如查询云手机列表.重启云手机.为云手机推送文件. 华为云帮助中心,为用户提供产品简介.价格说明.购 ...
thinkphp 助手函数url不生成https_如何用ThinkPHP框架写一个快递查询接口
ThinkPHP是php程序员们经常使用的框架之一,运用框架来开发网站无疑减轻了我们代码量,加快了我们的开发速度,框架底层封装的方法和函数使用起来简直不能太爽.今天给大家总结一个小案例,如何实现一个快 ...
Whois查询接口文档
Whois查询接口文档 whois(读作"Who is",非缩写)是用来查询域名的IP以及所有者等信息的传输协议.简单说,whois就是一个用来查询域名是否已经被注册,以及注册域名 ...

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

概述

快速开始

参数

响应

非常好用的节假日查询接口相关推荐

最新文章

热门文章