japan-holidays-api

内閣府データを元にした日本の祝日API

データソース: 内閣府 国民の祝日CSV
収録件数: 1067 件 / 期間: 1955-01-01 〜 2027-11-23
最終取得: 2026-07-03T06:59:35.876Z

エンドポイント

GET/holidays

祝日一覧を返します。クエリで絞り込み・出力形式を指定できます。

指定なしの場合は全件を返します。

GET/holidays/:year

指定年の祝日一覧。?format= に対応。

例: /holidays/2026 / /holidays/2026?format=yaml / /holidays/2026?format=sql

GET/holidays/date/:date

指定日 (YYYY-MM-DD) が祝日／休日かを判定します。

例: /holidays/date/2026-05-05

{
  "date": "2026-05-05",
  "weekday": "火",
  "isHoliday": true,
  "isWeekend": false,
  "isPublicRestDay": true,
  "name": "こどもの日"
}

• isHoliday … 内閣府データ上の祝日(振替休日・国民の休日を含む)
• isPublicRestDay … 土日 or 祝日

GET/calendar/:month

指定月 (YYYY-MM) の全日を、曜日・祝日・営業日フラグ付きで返します。稼働表づくりや、LLM に稼働表を生成させる用途向けです。?format=csv は表計算ソフトにそのまま貼れます。

例: /calendar/2026-07

[
  { "date": "2026-07-01", "weekday": "水", "isHoliday": false,
    "isWeekend": false, "isBusinessDay": true,  "name": null },
  { "date": "2026-07-04", "weekday": "土", "isHoliday": false,
    "isWeekend": true,  "isBusinessDay": false, "name": null },
  { "date": "2026-07-20", "weekday": "月", "isHoliday": true,
    "isWeekend": false, "isBusinessDay": false, "name": "海の日" }
]

• isBusinessDay … 土日でも祝日でもない稼働日
• 祝日一覧と違い、平日・土日も含めて1日ずつ返します。

GET/calendar

期間 (from, to 両端含む) の全日カレンダー。月をまたいだ範囲を一度に取れます (最大 1830 日)。

例: /calendar?from=2026-04-01&to=2026-06-30&format=csv

GET/holidays/renkyu/:year

指定年の連休(土日・祝日が連続する区間)一覧を返します。年末年始のように年をまたぐ連休も正しい日数で数えます。

GET/holidays/bridges/:year

有給を取ると連休になる提案を返します。両側を休日に挟まれた平日の小島(飛び石)を有給で埋めるケースだけを抽出するので、少ない有給で長い連休ができる「お得な」候補が並びます。

{
  "leaveDates": [{ "date": "2026-05-07", "weekday": "木" },
                 { "date": "2026-05-08", "weekday": "金" }],
  "leaveDays": 2,
  "breakStart": "2026-05-02",
  "breakEnd": "2026-05-10",
  "breakDays": 9,
  "efficiency": 4.5,
  "holidays": [ ... ]
}

• efficiency … 連休日数 ÷ 有給消費日数(お得度)
• 提案は1ギャップ単位です。隣接する提案をまとめて取ると、さらに長い連休にできる場合があります。

GET/

API情報とデータのメタ情報(JSON)。

出力フォーマット

format クエリで一覧系エンドポイントの出力形式を切り替えられます。