js怎么判断节假日

判断节假日的方法有多种：预定义节假日列表、使用API服务、结合公共假日算法。其中，预定义节假日列表是最直接且常用的方法，通过预先定义好的假日列表来判断某一天是否为假日。下面将详细介绍这种方法。

一、预定义节假日列表

1、创建节假日列表

预定义节假日列表是最简单直接的方法。你可以在代码中创建一个数组，存储所有节假日的日期。通过比较给定日期是否在数组中来判断是否为节假日。

// 定义节假日列表
const holidays = [
  '2023-01-01', // 元旦
  '2023-02-12', // 春节
  '2023-05-01', // 劳动节
  // 其他节假日
];
// 判断某天是否为节假日
function isHoliday(date) {
  return holidays.includes(date);
}
// 测试
const testDate = '2023-01-01';
console.log(isHoliday(testDate)); // true

2、动态节假日

一些节假日（如春节）日期每年不同，这种情况下需要根据具体年份动态生成节假日列表。

function getHolidays(year) {
  // 动态生成春节日期等
  const springFestival = calculateSpringFestival(year);
  return [
    `${year}-01-01`, // 元旦
    springFestival, // 春节
    `${year}-05-01`, // 劳动节
    // 其他节假日
  ];
}
function calculateSpringFestival(year) {
  // 使用农历算法计算春节日期
  // 这里只是一个示例，具体算法复杂
  return `${year}-02-12`;
}
// 判断某天是否为节假日
function isHoliday(date) {
  const year = date.split('-')[0];
  const holidays = getHolidays(year);
  return holidays.includes(date);
}
// 测试
const testDate = '2023-02-12';
console.log(isHoliday(testDate)); // true

二、使用API服务

1、公共假日API

使用在线API服务可以动态获取节假日信息，避免手动维护节假日列表。一般来说，API服务会提供RESTful接口，供我们查询某天是否为节假日。

// 使用fetch调用API
async function isHoliday(date) {
  const response = await fetch(`https://some-holiday-api.com/${date}`);
  const data = await response.json();
  return data.isHoliday;
}
// 测试
const testDate = '2023-01-01';
isHoliday(testDate).then(isHoliday => console.log(isHoliday)); // true

三、结合公共假日算法

1、计算固定假日

一些假日是固定日期，比如元旦、劳动节等。可以通过简单的比较来判断。

// 判断是否为固定假日
function isFixedHoliday(date) {
  const fixedHolidays = ['01-01', '05-01'];
  const monthDay = date.slice(5); // 获取MM-DD
  return fixedHolidays.includes(monthDay);
}
// 测试
const testDate = '2023-01-01';
console.log(isFixedHoliday(testDate)); // true

2、计算动态假日

计算动态假日如复活节，可以使用一些现成的算法。下面以复活节为例：

// 计算复活节日期
function calculateEaster(year) {
  const f = Math.floor,
        G = year % 19,
        C = f(year / 100),
        H = (C - f(C / 4) - f((8 * C + 13) / 25) + 19 * G + 15) % 30,
        I = H - f(H / 28) * (1 - f(H / 28) * f(29 / (H + 1)) * f((21 - G) / 11)),
        J = (year + f(year / 4) + I + 2 - C + f(C / 4)) % 7,
        L = I - J,
        month = 3 + f((L + 40) / 44),
        day = L + 28 - 31 * f(month / 4);
  return `${year}-${month.toString().padStart(2, '0')}-${day.toString().padStart(2, '0')}`;
}
// 判断是否为复活节
function isEaster(date) {
  const year = date.split('-')[0];
  const easterDate = calculateEaster(year);
  return date === easterDate;
}
// 测试
const testDate = '2023-04-09'; // 2023年复活节是4月9日
console.log(isEaster(testDate)); // true

四、综合判断

结合上述方法，可以创建一个综合判断函数，先判断固定假日，再判断动态假日，最后通过API查询。

async function isHoliday(date) {
  // 判断固定假日
  if (isFixedHoliday(date)) return true;
  // 判断动态假日
  if (isEaster(date)) return true;
  // 调用API查询其他假日
  const response = await fetch(`https://some-holiday-api.com/${date}`);
  const data = await response.json();
  return data.isHoliday;
}
// 测试
const testDate = '2023-01-01';
isHoliday(testDate).then(isHoliday => console.log(isHoliday)); // true

五、优化与扩展

1、缓存机制

为了提高性能，可以引入缓存机制，避免重复调用API。

const holidayCache = {};
async function isHoliday(date) {
  if (holidayCache[date] !== undefined) {
    return holidayCache[date];
  }
  if (isFixedHoliday(date) || isEaster(date)) {
    holidayCache[date] = true;
    return true;
  }
  const response = await fetch(`https://some-holiday-api.com/${date}`);
  const data = await response.json();
  holidayCache[date] = data.isHoliday;
  return data.isHoliday;
}
// 测试
const testDate = '2023-01-01';
isHoliday(testDate).then(isHoliday => console.log(isHoliday)); // true

2、支持多国家节假日

不同国家的节假日不同，可以通过参数指定国家，调用不同的API或使用不同的节假日列表。

async function isHoliday(date, country = 'us') {
  const response = await fetch(`https://some-holiday-api.com/${country}/${date}`);
  const data = await response.json();
  return data.isHoliday;
}
// 测试
const testDate = '2023-01-01';
isHoliday(testDate, 'cn').then(isHoliday => console.log(isHoliday)); // 根据中国节假日判断

六、实际应用案例

1、项目管理系统中的应用

在项目管理系统中，判断节假日可以用于自动排期、工时计算等场景。推荐使用研发项目管理系统PingCode和通用项目协作软件Worktile，它们都提供了丰富的功能支持，可以方便地集成节假日判断功能。

// 假设有一个任务排期功能，需要避开节假日
async function scheduleTask(startDate, duration) {
  let currentDate = new Date(startDate);
  let daysAdded = 0;
  while (daysAdded < duration) {
    currentDate.setDate(currentDate.getDate() + 1);
    const dateStr = currentDate.toISOString().split('T')[0];
    if (!await isHoliday(dateStr)) {
      daysAdded++;
    }
  }
  return currentDate;
}
// 测试
scheduleTask('2023-01-01', 5).then(endDate => console.log(endDate)); // 计算5个工作日后的日期

总结，通过预定义节假日列表、使用API服务以及结合公共假日算法，可以有效地判断某天是否为节假日。结合项目管理系统（如PingCode和Worktile）可以进一步优化和扩展节假日判断功能，使其在实际应用中更加高效和智能。