祝日カレンダーとAPI

日本の祝日を購読カレンダー(ics)とJSON APIで配信しています。どちらも登録不要・無料で、商用利用もできます。

カレンダーに登録する

下のURLを「URLで追加」に貼ると、お使いのカレンダーに日本の祝日が並びます。登録は一度だけで、翌年以降の祝日も自動で入ります。

https://dougudana.com/calendar/holidays.ics

Googleカレンダー

1. パソコンで Googleカレンダー を開きます
2. 左側の「他のカレンダー」の ＋ から「URLで追加」を選びます
3. 上のURLを貼って「カレンダーを追加」

スマートフォンのアプリからは追加できません。パソコンで追加すれば、同じアカウントのスマートフォンにも反映されます。

iPhone・iPad・Mac

1. iPhone / iPad は「設定」→「アプリ」→「カレンダー」→「アカウント」→「アカウントを追加」→「その他」→「照会するカレンダーを追加」
2. Mac のカレンダーアプリは「ファイル」→「新規照会カレンダー」
3. 上のURLを貼ります

Outlook

「カレンダーの追加」→「Webからの定期受信」に上のURLを貼ります。

中身について

• 振替休日と国民の休日を含みます。 日曜と重なった祝日の振替、祝日に挟まれた平日の扱いも入っています
• 終日の予定として入り、予定を占有しません。 空き時間の判定に影響しないので、仕事の予定表に入れても邪魔になりません
• 前年から10年先までを配信しています

JSON API

プログラムから使う場合はこちらです。どのドメインからでも読めます(CORS許可済み)。

年ごとの祝日

https://dougudana.com/api/holidays/2026.json

{
  "year": 2026,
  "count": 18,
  "holidays": {
    "2026-01-01": "元日",
    "2026-01-12": "成人の日",
    ...
  }
}

1980年から2099年まで引けます。「日付 → 名前」の形なので、同じ形式の他のデータと差し替えて使えます。

目録

https://dougudana.com/api/holidays.json — 引ける年の範囲と参照先を返します。

元号

https://dougudana.com/api/eras.json — 明治以降の5元号と、改元日を日付単位で返します。

なぜ正確だと言えるのか

祝日をデータ表として持たず、祝日法のルールから計算しています。 春分・秋分は近似式、ハッピーマンデーは「第n月曜」、振替休日と国民の休日はそれぞれの施行年から適用しています。

この方式には年次のデータ更新が要らないという利点がありますが、そのぶん実装の正しさがすべてになります。そこで、公表値との突合・全年で成り立つ性質(ハッピーマンデーは必ず月曜など)・施行年の前後や五輪特例といった境界を、自動テストで守っています。

ただし祝日法そのものが改正された場合(五輪特例のような一時的な移動を含む)は、こちらの更新が反映されるまで差が出ます。重要な手続きでは内閣府の発表をご確認ください。

利用条件

• 自由に使えます。 商用・非商用を問わず、クレジット表記も不要です
• 祝日の日付は祝日法から導かれる事実であり、こちらが権利を主張できるものではありません。データは CC0-1.0 として配信します
• 個人が運営しているため、可用性の保証はありません。 業務システムで使う場合は、取得した結果をそちら側でも保存しておくことをおすすめします

不具合や誤りを見つけた場合はお問い合わせからお知らせください。