jp-holidays

日本の祝日を計算で求める、依存ゼロのライブラリです。祝日のデータファイルを毎年更新する必要がありません。

• 固定日・ハッピーマンデー（成人の日・海の日・敬老の日・スポーツの日）
• 春分の日・秋分の日（天文近似式）
• 振替休日（祝日が日曜のとき）・国民の休日（祝日に挟まれた平日）
• 五輪特例（2020/2021 の海の日・スポーツの日・山の日の移動）
• 依存ゼロ・型定義つき・ESM をそのまま import

対応範囲：1980〜2099 年（春分・秋分の近似式が有効な範囲）。

インストール

npm install @suzukihayate/jp-holidays

使い方

import { holidays, isHoliday, holidayName } from '@suzukihayate/jp-holidays';

holidays(2024);
// [ { date: 2024-01-01, name: '元日' },
//   { date: 2024-01-08, name: '成人の日' }, ... 振替休日も含む ]

isHoliday('2024-05-03');   // true
isHoliday('2024-06-02');   // false
holidayName('2024-05-06'); // "振替休日"

API

• holidays(year) — その年の祝日を { date, name }[]（日付順）で返す
• isHoliday(input) — Date / "YYYY-MM-DD" が祝日か
• holidayName(input) — 祝日名（祝日でなければ null）

正確性

2024 年の全祝日（振替休日含む）、2020 年の五輪特例、国民の休日などをテストで検証しています（node --test）。春分・秋分は 1980〜2099 年で官報の確定日と一致する近似式を使用しています。

License

MIT © 2026 Hayate Suzuki