util-holidays

法定节假日查询（中国，定期维护）

安装

# 安装
npm i util-holidays
# 或者 yarn add util-holidays

支持离线、在线两种模式，支持typescript

离线模式（已支持2021年）

1. 因每年11月份左右公布下一年假期，所以离线模式需要每年更新版本，当前版本不属于当年时，会报错提示；

import { getDayInfo, isWorkingDay, isWeekend, isStatutoryHoliday } from 'util-holidays'

// 获取日期信息
getDayInfo('2020-10-01')
// 返回值结构：
{
    date: '2020-10-01',
    week: '星期四',
    type: '国庆节',
    dayType: 3,
    ps: 'dayType：1-工作日；2-周末；3-法定节假日；4-补休调工日'
}

// 判断是否工作日（含法定调工，如2020年10月10日）
isWorkingDay('2020-10-10')
// 判断是否正常休息的周末（不含法定调工，如2020年10月10日）
isWeekend('2020-10-10')
// 判断是否法定节假日
isStatutoryHoliday('2020-10-01')

在线模式

1. 在线模式首次启动或每次调用时，会检查本地数据，若不是当年，则调用接口更新本地数据；
2. 若有出网白名单限制的话，请将此API放行:https://util-holidays.beituyun.com/v1/queryData
3. 在线模式需要获取key并进行配置：

// key获取方式为：https://util-holidays.beituyun.com/v1/creatKey?phone=你的手机号
import { config } from 'util-holidays'
config({
    onLine: true,
    key: 'your key'
})

1. 在线离线支持随时切换，您可指定某一时刻才联网更新，并且更新后可关闭在线模式；
2. 其他用法同离线模式。

其他说明

1. 另提供免费的开放接口供大家使用，API地址：https://util-holidays.beituyun.com/v1/
2. 使用方法（均支持POST/GET，POST使用body，GET使用query）：
   • 获取节假日数据：/queryData, 入参key；
   • 获取日期信息，同getDayInfo：/getDayInfo, 入参key、date；
   • 创建key：/creatKey, 入参phone
3. 接口资源有限，因此限制每个key可以最高调用50次/s；