chinese-days/src/holidays/index.ts

中国节假日、调休日、工作日、24节气查询，农历阳历互转，支持 TS、CommonJS、UMD 模块化使用，提供 ics 日历格式，可供 Google Calendar、Apple Calendar、Microsoft Outlook 等客户端订阅。

import dayjs, { Dayjs, type ConfigType } from '../utils/dayjs';
import { wrapDate, getDates } from '../utils';
import generate from './generate';

const { holidays, workdays, inLieuDays } = generate();

// 已简化为仅处理单个日期参数
const _validateDate = (dateInput: ConfigType): Dayjs => {
  // wrapDate 函数处理 Dayjs 实例及其他可供 dayjs() 使用的类型
  const date = wrapDate(dateInput);
  if (!date.isValid()) {
    // 注意：错误信息使用 `typeof dateInput` 以反映传入的原始类型。
    // `typeof date` 对于 Dayjs 实例将是 'object'。
    throw new Error(
      `unsupported type ${typeof dateInput}, expected type is Date or Dayjs`
    );
  }
  return date;
};

/** 是否节假日 */
const isHoliday = (date: ConfigType): boolean => {
  return !isWorkday(date);
};

/** 是否工作日 */
const isWorkday = (date: ConfigType): boolean => {
  const validDate = _validateDate(date);
  const weekday = validDate.day();
  const formattedDate = validDate.format('YYYY-MM-DD');

  return !!(
    workdays[formattedDate] ||
    (weekday >= 1 && weekday <= 5 && !holidays[formattedDate])
  );
};

/** 是否调休日 - 是节假日，但后续有需要补班 */
const isInLieu = (date: ConfigType): boolean => {
  const validDate = _validateDate(date);
  return !!inLieuDays[validDate.format('YYYY-MM-DD')];
};

/** 获取工作日详情 */
const getDayDetail = (
  date: ConfigType
): { work: boolean; name: string; date: string } => {
  const validDate = _validateDate(date);
  const formattedDate = validDate.format('YYYY-MM-DD');
  if (workdays[formattedDate]) {
    return {
      date: formattedDate,
      work: true,
      name: workdays[formattedDate],
    };
  } else if (holidays[formattedDate]) {
    return {
      date: formattedDate,
      work: false,
      name: holidays[formattedDate],
    };
  } else {
    const weekday = validDate.day();
    return {
      date: formattedDate,
      work: weekday !== 0 && weekday !== 6,
      name: validDate.format('dddd'),
    };
  }
};

/** 获取节假日 */
const getHolidaysInRange = (
  startInput: ConfigType,
  endInput: ConfigType,
  includeWeekends: boolean = true
): string[] => {
  const start = _validateDate(startInput);
  const end = _validateDate(endInput);
  if (includeWeekends) {
    return getDates(start, end)
      .filter(isHoliday)
      .map(date => date.format('YYYY-MM-DD'));
  }
  return getDates(start, end)
    .filter(date => holidays[date.format('YYYY-MM-DD')])
    .map(date => date.format('YYYY-MM-DD'));
};

/** 获取工作日 */
const getWorkdaysInRange = (
  startInput: ConfigType,
  endInput: ConfigType,
  includeWeekends: boolean = true
): string[] => {
  const start = _validateDate(startInput);
  const end = _validateDate(endInput);
  if (includeWeekends) {
    return getDates(start, end)
      .filter(isWorkday)
      .map(date => date.format('YYYY-MM-DD'));
  }
  return getDates(start, end)
    .filter(date => isWorkday(date) && date.day() >= 1 && date.day() <= 5)
    .map(date => date.format('YYYY-MM-DD'));
};

/* 查找从 date 开始 第 n 个工作日, 0 为当天 */
const findWorkday = (
  deltaDays: number = 0,
  date: ConfigType = dayjs()
): string => {
  date = wrapDate(date);

  if (deltaDays === 0) {
    if (isWorkday(date)) {
      return date.format('YYYY-MM-DD');
    }
    deltaDays = 1;
  }

  const sign = deltaDays > 0 ? 1 : -1;
  let daysToAdd = Math.abs(deltaDays);

  while (daysToAdd > 0) {
    date = date.add(sign, 'day');
    if (isWorkday(date)) {
      daysToAdd--;
    }
  }

  return date.format('YYYY-MM-DD');
};

export {
  isHoliday,
  isWorkday,
  isInLieu,
  getDayDetail,
  getHolidaysInRange,
  getWorkdaysInRange,
  findWorkday,
};