レスポンスに含まれる項目
Nager.Date で国と年ごとの祝日を調べ、全国対象か地域対象かを読み取り、カレンダー作成の出発点として使えます。
全国対象として載っている祝日でも、特定の都市における銀行、学校、店舗、配送、行政機関の営業時間までは判断できません。期限、休暇、支払い、窓口時間を案内する前に subdivisionCodes、holidayTypes と担当機関の公式情報を確認してください。
確認したい項目
- ISO 形式の日付
- 祝日の名称
- 全国または地域の対象範囲
- 祝日の種類
Nager.Date
Nager.Date で国と年ごとの祝日を調べ、全国対象か地域対象かを読み取り、カレンダー作成の出発点として使えます。
現在の公開データ
Nager.Date から応答を読み込みます。検索語の入力は不要です。
年ごとの照会で返る内容
Holidays ルートではパスに国と年を入れます。BR と 2026 の場合、確認した応答はオブジェクトの一覧です。各オブジェクトには YYYY-MM-DD 形式の date、name、countryCode、nationalHoliday、subdivisionCodes、holidayTypes が含まれます。すべての祝日が国全体に当てはまるわけではないため、全員が休みと判断する前に対象範囲を確認します。
- countryCode は照会した国のコードであり、都市を示すものではありません。
- nationalHoliday と subdivisionCodes を合わせて読みます。日付が特定の地域に限られることがあります。
- holidayTypes は分類であり、地域の営業時間を確定する情報ではありません。
役立つ照会の組み立て方
まず二文字の ISO 国コードを選び、次に予定を立てる年を選びます。このページでは BR と 2026 を例にしています。年単位の応答なら、項目を一つの一覧で比べられるためです。チームの予定表では、各項目を全国共通の休日にせず、日付と対象範囲を分けて保存します。
- 期間の異なるカレンダーを混ぜないよう、URL に年を明示します。
- 別のプロジェクトで応答を使い回す前に、国コードが正しいか確認します。
- 必要な場所や規則に合う日付だけを並べ替えて目立たせます。
期限に使う前の注意
祝日の一覧は計画に便利ですが、サービス、銀行決済、配送、授業、法的義務が実行されるかどうかを単独では決められません。対象範囲は都市、機関、活動によって変わります。金銭、契約、公的期限、旅行に影響する場合は、担当機関、企業、サービスで規則を確認してください。
- 返された項目を確認せず、地域の休日を全国的な休業として案内しないでください。
- API だけを根拠に法定期限を計算しないでください。
- 特定の時間や義務に基づく判断では、確認した公式情報を記録します。
