117
81

More than 3 years have passed since last update.

日本の祝日を JSON / CSV 形式で返す API

Last updated at Posted at 2016-12-07

昨年・今年・来年の国民の祝日を、一覧として返すAPIです。

仕組み

  • Google カレンダーの「日本の祝日」情報をもとに、JSON / CSV データを吐き出すスクリプトを作成
  • GitHub Actions にてビルド
  • ビルド結果のファイルを GitHub のリポジトリにプッシュ
  • GitHub Pages にてホスティング

ビルドは定期的に実行され、内容は自動更新されます。

URL

一覧 (date)

{
    "2016-12-23": "天皇誕生日",
    "2017-01-01": "元日",
    "2017-01-02": "元日 振替休日"
}

一覧 (unixtime)

キーを Y-m-d ではなく unixtime として返す

{
    "1482418800": "天皇誕生日",
    "1483196400": "元日",
    "1483282800": "元日 振替休日"
}

年別 (date)

指定された年の祝日だけを返す

{
    "2017-01-01": "元日",
    "2017-01-02": "元日 振替休日",
    "2017-01-09": "成人の日"
}

年別 (unixtime)

{
    "1483196400": "元日",
    "1483282800": "元日 振替休日",
    "1483887600": "成人の日"
}

CSV形式

地味にCSV形式にも対応しています、URL末尾の拡張子部分を .csv にすれば CSV形式で返却されます。

例: 一覧 (date)

2017-01-01,元日
2017-01-02,"元日 振替休日"
2017-01-09,成人の日

ライセンス

MITライセンス

リンク

GitHub
https://github.com/holidays-jp/

紹介ブログ
https://blog.monaural.net/post/holidays-jp-api/

追記

  • 2021.09.11
    • ビルド処理を Travis CI から GitHub Actions に移行しました
117
81
4

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
117
81