koyomi

指定された西暦の年の、(1)国民の祝日、(2)二十四節気および雑節、(3)朔弦望の情報をjson形式で返却するAPIエンドポイントです。

(1)国民の祝日は、内閣府が公開しているcsv ファイルの情報に基づいています。
(2)二十四節気および雑節、(3)朔弦望は、国立天文台の暦要項の情報に基づいています。

自由にご利用いただけます。常識の範囲内でご利用ください。 ご利用の際の責任はすべてご利用者にあるものとし、コンテンツの内容を含めて、当方に責任は一切無いものとします。

specification

endpoint

GET https://koyomi.techjunk.net/{type}/{year}

parameters

type

holiday

国民の祝日の情報を返却します。

sekki

二十四節気および雑節の情報を返却します。

sakubou

朔弦望の情報を返却します。

all

国民の祝日、二十四節気および雑節、朔弦望の情報を返却します。

year

情報を取得したい年の西暦を指定します。year >= 2004 のとき、有効な情報を取得できます。

response

指定した、type, year に応じて、下記の内容が json形式で返却されます。
type が all の場合、holiday, sekki, sakubou の内容が返却されます。
all 以外の場合、指定した項目の内容のみが返却されます。

{
  "year": "YYYY",
  "holiday": [
    {
      "date": "MMDD",
      "name": "元日"
    },
    :
  ]
  "sekki": [
    {
      "date": "MMDD",
      "name": "小寒"
    },
    :
  ]
  "sakubou": [
    {
      "date": "MMDD",
      "name": "望"
    },
    :
  ]
}

example

curl -s https://koyomi.techjunk.net/all/2004 | jq .

ical ファイル

暦の情報(国民の祝日、二十四節気および雑節、朔弦望の情報)を記載したicalファイルです。 カレンダーアプリに取り込むなどしてご利用頂けます。

2022 - 2025年の情報が記載されています。