Nager.Date Holidays

日付 · 現地名 · 対象範囲 · 祝日の種類

公式ドキュメント

ライブ検索

実際の語句を入力し、カードで返答を確認してから詳しいソースを開けます。

検索例

レスポンスに含まれる項目

BR、US、JP を試し、返された項目から目的のレコードを特定してください。

確認したい項目

日付
現地名
対象範囲
祝日の種類

国と年で参照する暦が決まります

祝日の照会では国コードを使い、年別のエンドポイントでは年も指定します。各項目には date、localName、name、countryCode が含まれます。date は YYYY-MM-DD 形式で、localName はその国で使われる名称を保ち、name は別の表記になることがあります。同じ行事でも場所によって名称や日付が異なるため、比較前に国と年を選んでください。

BR、US、JP のような二文字の国コードを使います。
国際的な予定表では countryCode を日付と一緒に保持します。
地域の文脈が大切なときは localName を表示します。

対象範囲と種別は慎重に読みます

global、counties、types は項目の対象範囲を読む助けになります。祝日が国全体に当てはまらない場合や、counties に地域的な範囲が示される場合があります。types は情報源内の分類であり、法律、雇用契約、学校暦、地方当局の告知の確認に代わるものではありません。照会の整理に使い、義務の断定には使わないでください。

日付を全国共通と扱う前に counties を確認します。
types は情報源による分類として表示します。
公式な判断には、該当する地域または機関の暦を確認します。

将来の日付は改めて照会します

API には年別リストと次の祝日のルートがあります。fixed と launchYear は一部の結果のメタデータですが、返る集合は指定した国と期間に結び付いています。将来の日付に予定が依存する場合は利用時期の近くで再照会し、取得時点を記録してください。古い一覧を別の年や場所へ流用することを防げます。

年別リストは決まった期間の計画に使います。
次の祝日は短期の最新表示に使います。
暦を公開するときは年、国、照会時点を記録します。