jayding/chinese-holiday

check whether it is a working day

1.0.6 2020-12-09 01:42 UTC

This package is auto-updated.

Last update: 2024-09-09 10:44:47 UTC


README

[TOC]

jayding/chinese-holiday

前言

快速获取指定 年 月 日的节假日信息,测试非商用

快速上手

  • composer requrie jayding/chinese-holiday
$holiday = new \Holiday\Holiday();
var_dump($holiday->check('2020-10-01'));

获取指定年份、月份的节日

接口名

getHolidayYear('2020')				年份
getHolidayMonth('2020-08')			月份

返回值说明

{
  "code": 0,               // 0服务正常。-1服务出错
  "holiday": {
    "10-01": {
      "holiday": true,     // 该字段一定为true
      "name": "国庆节",     // 节假日的中文名。
      "wage": 3,           // 薪资倍数,3表示是3倍工资
      "date": "2018-10-01" // 节假日的日期
    },
    "10-02": {
      "holiday": true,     // 该字段一定为true
      "name": "国庆节",     // 节假日的中文名。
      "wage": 3,           // 薪资倍数,3表示是3倍工资
      "date": "2018-10-01" // 节假日的日期
    }
  },
  "type": {                     // 只有明确指定参数 type=Y 时才返回类型信息
    "2018-10-01": {             // 一一对应holiday对象的key,holiday有多少个这里就有多少个
      "type": enum(0, 1, 2, 3), // 节假日类型,分别表示 工作日、周末、节日、调休。
      "name": "周六",            // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
      "week": enum(1 - 7)       // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
    }
  }
}

获取指定日期

接口名

getHolidayDay(2020-08-02)

返回值说明

{
  "code": 0,              // 0服务正常。-1服务出错
  "type": {
    "type": enum(0, 1, 2, 3), // 节假日类型,分别表示 工作日、周末、节日、调休。
    "name": "周六",         // 节假日类型中文名,可能值为 周一 至 周日、假期的名字、某某调休。
    "week": enum(1 - 7)    // 一周中的第几天。值为 1 - 7,分别表示 周一 至 周日。
  },
  "holiday": {
    "holiday": false,     // true表示是节假日,false表示是调休
    "name": "国庆前调休",  // 节假日的中文名。如果是调休,则是调休的中文名,例如'国庆前调休'
    "wage": 1,            // 薪资倍数,1表示是1倍工资
    "after": false,       // 只在调休下有该字段。true表示放完假后调休,false表示先调休再放假
    "target": '国庆节'     // 只在调休下有该字段。表示调休的节假日
  }
}