关于php:非常好用的节假日查询接口

8次阅读

共计 1161 个字符,预计需要花费 3 分钟才能阅读完成。

概述

平时在开发的过程中常常会用到查问节假日的性能,但因为节假日是每年由国务院对立颁布,咱们
无奈通过计算获取节假日,所以个别须要咱们手动来保护节假日。
网上有很多节假日查问的接口,但查问条件和返回后果并不是太现实,
于是就本人写了个节假日查问接口并提供一个简略的页面。接口提供丰盛的查问参数并且响应的字段能够自在定制。

疾速开始

节假日查问的 接口地址 为:
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,失败时为 枚举值 中的 key
  • msg 胜利时始终为 ok 失败时为 枚举值 中的 value
  • data 胜利时返回数据,失败时局部返回失败数据,如表单验证失败。
正文完
 0