第一種：
npm i chinese-days

import chineseDays from 'chinese-days'

第二種：
直接瀏覽器引入，會(huì)跟隨國(guó)務(wù)院發(fā)布更新
<script src="https://cdn.jsdelivr.net/npm/chinese-days/dist/index.min.js"></script>
<script>
  const { isHoliday } = chineseDays
  console.log(isHoliday('2022-01-01'))
</script>

isWorkday 檢查某個(gè)日期是否為工作日 console.log(isWorkday('2024-01-01')); // false
isHoliday 檢查某個(gè)日期是否為節(jié)假日 console.log(isHoliday('2024-01-01')); // true

isInLieu 檢查某個(gè)日期是否為調(diào)休日

getDayDetail 檢查指定日期是否是工作日
// 示例用法
如果指定日期是工作日，則返回 true 和工作日名稱，如果是被調(diào)休的工作日，
返回 true 和節(jié)假日詳情。如果是節(jié)假日，則返回 false 和節(jié)假日詳情。
// 正常工作日 周五
console.log(getDayDetail('2024-02-02')); // { "date": "2024-02-02", "work":true,"name":"Friday"}
// 節(jié)假日 周末
console.log(getDayDetail('2024-02-03')); // { "date": "2024-02-03", "work":false,"name":"Saturday"}
// 調(diào)休需要上班
console.log(getDayDetail('2024-02-04')); // { "date": "2024-02-04", "work":true,"name":"Spring Festival,春節(jié),3"}
// 節(jié)假日 春節(jié)
console.log(getDayDetail('2024-02-17')); // { "date": "2024-02-17", "work":false,"name":"Spring Festival,春節(jié),3"}

getHolidaysInRange 獲取指定日期范圍內(nèi)的所有節(jié)假日

接收起始日期和結(jié)束日期，并可選地決定是否包括周末。
如果包括周末，則函數(shù)會(huì)返回包括周末在內(nèi)的所有節(jié)假日；否則，只返回工作日的節(jié)假日。
即使不包括周末，周末的節(jié)假日仍然會(huì)被返回
// 示例用法
const start = '2024-04-26';
const end = '2024-05-06';

// 獲取從 2024-05-01 到 2024-05-10 的所有節(jié)假日，包括周末
const holidaysIncludingWeekends = getHolidaysInRange(start, end, true);
console.log('Holidays including weekends:', holidaysIncludingWeekends.map(d => getDayDetail(d)));

// 獲取從 2024-05-01 到 2024-05-10 的節(jié)假日，不包括周末
const holidaysExcludingWeekends = getHolidaysInRange(start, end, false);
console.log('Holidays excluding weekends:', holidaysExcludingWeekends.map(d => getDayDetail(d)));

接收起始日期和結(jié)束日期，并可選地決定是否包括周末。如果包括周末，則函數(shù)會(huì)返回包括周末在內(nèi)的所有工作日；否則，只返回周一到周五的工作日。
// 示例用法
const start = '2024-04-26';
const end = '2024-05-06';

// 獲取從 2024-05-01 到 2024-05-10 的所有工作日，包括周末
const workdaysIncludingWeekends = getWorkdaysInRange(start, end, true);
console.log('Workdays including weekends:', workdaysIncludingWeekends);

// 獲取從 2024-05-01 到 2024-05-10 的工作日，不包括周末
const workdaysExcludingWeekends = getWorkdaysInRange(start, end, false);
console.log('Workdays excluding weekends:', workdaysExcludingWeekends);

查找從今天開(kāi)始 未來(lái)的第 {deltaDays} 個(gè)工作日。

// 查找從今天開(kāi)始 未來(lái)的第 {deltaDays} 個(gè)工作日
// 如果 deltaDays 為 0，首先檢查當(dāng)前日期是否為工作日。如果是，則直接返回當(dāng)前日期。
// 如果當(dāng)前日期不是工作日，會(huì)查找下一個(gè)工作日。
const currentWorkday = findWorkday(0);
console.log(currentWorkday);

// 查找從今天開(kāi)始未來(lái)的第一個(gè)工作日
const nextWorkday = findWorkday(1);
console.log(nextWorkday);

// 查找從今天開(kāi)始之前的前一個(gè)工作日
const previousWorkday = findWorkday(-1);
console.log(previousWorkday);

// 可以傳第二個(gè)參數(shù) 查找具體日期的上下工作日
// 查找從 2024-05-18 開(kāi)始，未來(lái)的第二個(gè)工作日
const secondNextWorkday = findWorkday(2, '2024-05-18');
console.log(secondNextWorkday);

import { getSolarTerms } from "chinese-days";

/** 獲取范圍內(nèi) 節(jié)氣日期數(shù)組 */
const solarTerms = getSolarTerms("2024-05-01", "2024-05-20");
solarTerms.forEach(({ date, term, name }) => {
  console.log(`${name}: ${date}, ${term}`);
});
// 立夏: 2024-05-05, the_beginning_of_summer
// 小滿: 2024-05-20, lesser_fullness_of_grain

// 沒(méi)有節(jié)氣 返回 []
getSolarTerms("2024-05-21", "2024-05-25");
// return []

/* 不傳 end 參數(shù)， 獲取某天 節(jié)氣 */
getSolarTerms("2024-05-20");
// return: [{date: '2024-05-20', term: 'lesser_fullness_of_grain', name: '小滿'}]

// 2097-8-7
console.log(getLunarDate('2097-08-07'))

// 2057-9-28
console.log(getLunarDate('2057-09-28'))
// {
//   date: "2057-09-28",
//   lunarYear: 2057,
//   lunarMon: 8,
//   lunarDay: 30,
//   isLeap: false,
//   lunarDayCN: "三十",
//   lunarMonCN: "八月",
//   lunarYearCN: "二零五七",
//   yearCyl: "丁丑",
//   monCyl: "己酉",
//   dayCyl: "戊子",
//   zodiac: "牛"
// }

// 非閏月 和 閏月例子
console.log(getLunarDate('2001-04-27'))
console.log(getLunarDate('2001-05-27'))

console.log(getLunarDatesInRange('2001-05-21', '2001-05-26'))

當(dāng)為陰歷閏月的時(shí)候，會(huì)出現(xiàn)一個(gè)農(nóng)歷日期對(duì)應(yīng)兩個(gè)陽(yáng)歷日期的情況，所以返回對(duì)象形式。
console.log(getSolarDateFromLunar('2001-03-05'))
// {date: '2001-03-29', leapMonthDate: undefined}

console.log(getSolarDateFromLunar('2001-04-05'))
// {date: '2001-04-27', leapMonthDate: '2001-05-27'}