<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Festival_chn Example</title>
  </head>
  <body>
    <script src="./dist/festival.js"></script>
    <script>
      const getSwapHolidaysInRange = Festival.getSwapHolidaysInRange(20230101, 20230131)
      console.log('getSwapHolidaysInRange ===>', getSwapHolidaysInRange)
    </script>
  </body>
</html>

在 Node.js 中使用

const { Festival_chn } = require('festival_chn');
const festival = new Festival();
const dayInfo = festival.day(20220101);
console.log(dayInfo.name); // "元旦"

查询某天的节日和假期信息

const festival = new Festival();
const dayInfo = festival.day(20220101);
console.log(dayInfo);

{
  date: 20220101,
  name: "元旦",
  isHoliday: true,
  isLegal: true,
  isSwap: false
}

返回的结果对象包含以下字段：

字段名称	字段类型	说明
date	Number	八位数字组成的年月日
name	String	节日名称
isHoliday	Boolean	是否为假期节假日
isLegal	Boolean	是否为法定节假日
isSwap	Boolean	是否为调休日

查询某天的假期名称

const festival = new Festival();
const name = festival.name(20220101);
console.log(name); // "元旦"

判断某天是否为节日和假期

const festival = new Festival();
const isHoliday = festival.isHoliday(20220101);
console.log(isHoliday); // true

const isLegal = festival.isLegal(20220101);
console.log(isLegal); // true

const isSwap = festival.isSwap(20220101);
console.log(isSwap); // false

查询指定日期范围内的假期信息

const festival = new Festival();
const daysInRange = festival.getDaysInRange(20230101, 20230131);
console.log(daysInRange);

查询指定日期范围内的法定假日

const festival = new Festival();
const legalHolidays = festival.getLegalHolidaysInRange(20230101, 20230131);
console.log(legalHolidays);

查询指定日期范围内的调休日

const festival = new Festival();
const count = festival.getHolidaysInRange(20230101, 20230131);
console.log(count);

查询指定日期范围内的假期天数

const festival = new Festival();
const count = festival.countHolidaysInRange(20230101, 20230131);
console.log(count);

更新计划

setStartDate(year)：设置数据源的起始年份，默认为 1970。一般情况下不需要调用此方法。
setEndDate(year)：设置数据源的终止年份，默认为 2050。一般情况下不需要调用此方法。
getDayInfo(date)：查询指定日期的节日和假期信息，与 day 方法相同。

数据源

Festival_chn 内置了中国节日和法定节假日的数据源，其基本来源于互联网上公开的数据。如果你需要更新数据源，可以修改 chn文件夹下的三个文件。

注意事项

由于中国国家法定节假日的调休规则相对复杂，如果需要进行严格的判断和计算，请慎重使用本库。例如，如何判断 2021 年端午节和中秋节的调休情况，需要考虑到国务院发布的调休政策和各省市的具体实施情况，需要一定的研究和验证。本库只能作为预估和参考之用，不保证其完全正确性和准确性，使用者应自行验证并承担风险。

License

MIT

FAQs

What is festival_chn?

Is festival_chn popular?

Is festival_chn well maintained?

Package last updated on 31 Dec 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

festival_chn

Festival_chn

安装

使用

浏览器中使用