祝日取得
/holiday [GET]
基本情報
概要
指定期間に含まれる祝日リストを返却します。
URL
https://{HOST}/{CID}/v1/holiday
※RapidAPIでは提供しておりません
出力形式
- JSON
対応言語
- ja
出力順
- 日付の昇順
祝日のデータについて
祝日データは毎年12月に更新されます。
その際に前年分のデータが削除、来年分のデータが追加されます。
パラメータ
パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
---|---|---|---|---|---|---|
start_date | 検索対象開始日 | 文字列(日付) YYYY-MM-DD |
現在日付 | 上限:現在日付から1年後まで 下限:現在日付から1年前まで |
||
end_date | 検索対象終了日 | 文字列(日付) YYYY-MM-DD |
現在日付から1年後 | 上限:現在日付から1年後まで 下限:現在日付から1年前まで |
end_dateのみを指定する場合について
end_dateのみを指定する際に、現在日付より過去の日付を指定することはできません。ご注意ください。
start_dateは現在日付(デフォルト値)となり、検索対象期間の時系列に逆転が起きるためです。
例えば、2022年5月9日に/holiday?end_date=2022-05-08とリクエストした際にはエラーが返却されます。
パラメータ構成例
- 2022年の祝日を検索
/holiday?start_date=2022-01-01&end_date=2022-12-31
レスポンス
名称 | レスポンス名 | 型名 | 配列 | 説明 |
---|---|---|---|---|
祝日情報 | items | HolidayInfoオブジェクト | 〇 |
HolidayInfoオブジェクト
名称 | レスポンス名 | 型名 | 配列 | 説明 |
---|---|---|---|---|
日付 | date | 文字列 | ||
曜日 | day_of_week | 文字列 | ||
祝日の名称 | name | 文字列 |
レスポンス例
{ "items": [ { "date": "2022-01-01", "day_of_week": "saturday", "name": "元日" }, { "date": "2022-01-10", "day_of_week": "monday", "name": "成人の日" }, { "date": "2022-02-11", "day_of_week": "friday", "name": "建国記念の日" }, { "date": "2022-02-23", "day_of_week": "wednesday", "name": "天皇誕生日" }, { "date": "2022-03-21", "day_of_week": "monday", "name": "春分の日" }, { "date": "2022-04-29", "day_of_week": "friday", "name": "昭和の日" }, { "date": "2022-05-03", "day_of_week": "tuesday", "name": "憲法記念日" }, { "date": "2022-05-04", "day_of_week": "wednesday", "name": "みどりの日" }, { "date": "2022-05-05", "day_of_week": "thursday", "name": "こどもの日" }, { "date": "2022-07-18", "day_of_week": "monday", "name": "海の日" }, { "date": "2022-08-11", "day_of_week": "thursday", "name": "山の日" }, { "date": "2022-09-19", "day_of_week": "monday", "name": "敬老の日" }, { "date": "2022-09-23", "day_of_week": "friday", "name": "秋分の日" }, { "date": "2022-10-10", "day_of_week": "monday", "name": "スポーツの日" }, { "date": "2022-11-03", "day_of_week": "thursday", "name": "文化の日" }, { "date": "2022-11-23", "day_of_week": "wednesday", "name": "勤労感謝の日" } ] }