暦API

1900年から2100年までの毎日について、旧暦・六曜・干支・二十四節気・雑節・月齢・和暦を返すAPIです。カレンダーに六曜を添える、大安の日を拾う、その年の二十四節気を一覧にする、といったことが手軽にできます。

できること

日ごとの 旧暦（閏月つき）・六曜・日の干支・二十四節気・雑節・月齢・月の満ち欠け・和暦 ／ 年ごとの 二十四節気と雑節の日時・新月と満月などの日時・年の干支

期間

1900年1月1日〜2100年12月31日（1年分を1つのファイルで返します）

費用・登録

無料・登録不要・APIキー不要（提供条件は利用状況で変わることがあります）

計算のもと

NASA JPL の天体暦 DE440s。国立天文台の暦要項（2004〜2027年）と、二十四節気・雑節・朔弦望の日付がすべて一致

気をつけること

祝日は入っていません（祝日・営業日APIを併せて使ってください）。六曜・干支などは迷信・慣習としての参考情報です。

データの版は /koyomi/v1/meta.json で確認できます。

はじめかた（3ステップ）

1. ブラウザで開いてみる: https://api.shirugear.com/koyomi/v1/2026.json を開くと、2026年の365日分の暦が返ります。URLの数字を調べたい年に変えるだけです。
2. その日の1件を取り出す: days の中から date が目当ての日付（例: "2026-11-01"）のものを探します。使い方の例にそのまま使えるコードがあります。
3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

サーバー側のプログラムやコマンドからも、URLを開くだけで使えます。1年分（約100KB、通信は圧縮されて約14KB）を1回で受け取れるので、手元に保存して使い回すと効率的です。

const res = await fetch("https://api.shirugear.com/koyomi/v1/2026.json");
const data = await res.json();
const day = data.days.find((d) => d.date === "2026-11-03");
console.log(day.rokuyo, "旧暦" + day.lunar.text); // 友引 旧暦9月24日

curl -s https://api.shirugear.com/koyomi/v1/2026.json \
  | jq '.days[] | select(.date == "2026-11-03") | {rokuyo, lunar: .lunar.text}'

<?php
$data = json_decode(file_get_contents('https://api.shirugear.com/koyomi/v1/2026.json'), true);
foreach ($data['days'] as $day) {
    if ($day['date'] === '2026-11-03') {
        echo $day['rokuyo'], ' 旧暦', $day['lunar']['text'], "\n"; // 友引 旧暦9月24日
    }
}

import json
import urllib.request

url = "https://api.shirugear.com/koyomi/v1/2026.json"
with urllib.request.urlopen(url, timeout=10) as res:
    data = json.load(res)
day = next(d for d in data["days"] if d["date"] == "2026-11-03")
print(day["rokuyo"], "旧暦" + day["lunar"]["text"])  # 友引 旧暦9月24日

その場で試す

URLの一覧

どれも、URLを開く（GET）だけで JSON（UTF-8）が返ります。先頭は https://api.shirugear.com です。自分のサイトのJavaScriptから直接呼べます（CORS対応）。

• 年は半角数字4桁の西暦で指定します（2026）。和暦や2桁の年は使えません。
• 1日分・1か月分だけを返すURLはありません。年のファイル（約100KB、圧縮して約10KB）を一度取り、その中から引いてください。
• 祝日・休日は入っていません。祝日・営業日APIの同じ年のファイルと、日付で突き合わせて使ってください。
• 呼び出しは GET（または HEAD）だけです。独自のヘッダを付けずに呼んでください。

コマンドラインからは、たとえば次のようにその日の1件を取り出せます（jq を使う例）。

curl -s https://api.shirugear.com/koyomi/v1/2026.json | jq '.days[] | select(.date == "2026-11-01")'

応答の例と各項目

応答の例

GET https://api.shirugear.com/koyomi/v1/2026.json

{
  "year": 2026,
  "wareki": "令和8年",
  "kanshi": "丙午",
  "kanshi_kana": "ひのえうま",
  "days": [
    …
    {
      "date": "2026-02-17",
      "weekday": "火",
      "wareki": "令和8年",
      "lunar": { "year": 2026, "month": 1, "day": 1, "leap": false, "text": "1月1日" },
      "rokuyo": "先勝",
      "kanshi": "壬戌",
      "kanshi_kana": "みずのえいぬ",
      "sekki": null,
      "zassetsu": [],
      "moon_age": 29.3,
      "moon_phase": "新月"
    },
    …
  ],
  "solar_terms": [
    { "name": "小寒", "kana": "しょうかん", "longitude": 285, "date": "2026-01-05", "at": "2026-01-05T17:23:09+09:00" },
    …
  ],
  "zassetsu": [
    { "name": "土用入り", "season": "冬", "label": "冬の土用入り", "date": "2026-01-17", "at": "2026-01-17T12:03:09+09:00" },
    { "name": "土用の丑の日", "season": "冬", "label": "冬の土用の丑の日", "date": "2026-01-27" },
    { "name": "節分", "label": "節分", "date": "2026-02-03" },
    …
  ],
  "moon_phases": [
    { "name": "満月", "date": "2026-01-03", "at": "2026-01-03T19:02:55+09:00" },
    …
  ],
  "data_version": "2026-11-01"
}

2026年2月17日は旧暦の1月1日（旧正月）です。新月の瞬間は21時01分で、月齢は正午の値なので、この日は 29.3 になっています（月齢と月の満ち欠け）。

年の項目

日付はすべて "YYYY-MM-DD"、時刻はすべて日本時間の "YYYY-MM-DDTHH:MM:SS+09:00"（ISO 8601）です。

days の各項目（1日分）

days は1月1日から順に並んでいるので、その年の何日目かが分かれば番号でも引けます（1月1日が days[0]）。

旧暦と六曜の決め方（2033年問題）

旧暦は、明治5年（1872年）まで使われていた太陰太陽暦（天保暦）の決め方に沿って、天文計算から求めています。旧暦はいまの日本では公式に定められた暦ではありません。作り手によって細かな決め方が違うため、市販のカレンダーなどと食い違うことがあります。

旧暦の決め方

1. 月の始まり: 新月（朔）の瞬間がある日（日本時間）を、旧暦の月の1日とします。次の新月の日の前日までがその月です（29日か30日）。
2. 月の番号: 冬至を含む月を11月とします。そこから順に12月・1月…と数えます。
3. 閏月: 冬至を含む月から次の冬至を含む月までが13か月あるときは、その間で中気（太陽の黄経が30°の倍数になる二十四節気）を含まない最初の月を閏月とし、前の月と同じ番号にします（例: 6月の次の閏月は「閏6月」）。
4. 旧暦の年: 旧暦の1月1日（旧正月）がある西暦の年で数えます。旧正月より前の日は、前の年の11月・12月です。

2033年問題

2033年の秋から2034年の春にかけては、天保暦の決め方をそのまま当てはめると、月の名前が一通りに決まりません。これを「旧暦2033年問題」と呼びます。

• このAPIでは、上の決め方のとおり、2033年12月22日からの月を閏11月としています。日本カレンダー暦文化振興協会の見解と同じです。
• ほかに、閏7月とする暦や、2034年の閏1月とする暦もあります。方式によって、2033年秋から2034年春にかけての旧暦の日付と六曜が違います。
• 大事な予定にこの期間の旧暦・六曜を使うときは、使う暦がどの方式かを確かめてください。

六曜の決め方

六曜は、旧暦の月と日から決まります。（旧暦の月 ＋ 旧暦の日）を6で割った余りで次のように決めます。閏月は同じ番号の月として数えます（閏11月は11月と同じ）。

このため、旧暦の各月の1日は決まった六曜から始まります（1月・7月は先勝、2月・8月は友引、3月・9月は先負、4月・10月は仏滅、5月・11月は大安、6月・12月は赤口）。旧暦の月が変わる日は、六曜の並びが途中で飛びます。

六曜・干支などの暦注は、迷信・慣習としての参考情報です。科学的な根拠を示すものではありません。

二十四節気と雑節

二十四節気

太陽の通り道（黄道）を15°ずつ24に分け、太陽がそれぞれの角度（黄経）に来た瞬間を二十四節気とします。sekki にはその瞬間がある日（日本時間）に名前が入り、年の solar_terms には秒までの時刻が入ります。黄経が30°の倍数のもの（春分・穀雨・小満…）を「中気」と呼び、旧暦の月の番号を決めるのに使います。

雑節

雑節は、二十四節気のほかに季節の目安として使われてきた日です。このAPIでは次のものを入れています（社日は入れていません）。

• 土用の期間（約18日）に丑の日が2回あるときは、両方入ります（2回目がいわゆる「二の丑」）。
• 日の zassetsu には label が入ります。季節を除いた名前で調べたいときは、年の zassetsu の name を使ってください。
• 雑節の決め方は、国立天文台の暦要項にならっています。地域や流儀によって別の決め方をすることもあります。

月齢と月の満ち欠け

• 月齢（moon_age）: その日の正午（日本時間）の時点で、直前の新月の瞬間から何日たったかです。小数1桁に四捨五入しています。新月から満月まではおよそ14.8日、次の新月まではおよそ29.5日です。
• 月の満ち欠け（moon_phase）: その日（日本時間の0時から24時まで）に、新月・上弦・満月・下弦の瞬間があれば、その名前が入ります。年の moon_phases には秒までの時刻が入ります。
• 新月の瞬間が正午より後の日は、月齢が 29 前後のまま moon_phase が「新月」になります（例: 2026年2月17日は新月が21時01分なので月齢 29.3、翌日が 0.6）。月齢が0になる日と新月の日は、1日ずれることがあります。
• 旧暦の日付（新月の日が1日）と月齢はおおむね「旧暦の日 − 1 ≒ 月齢」ですが、月齢は正午の値、旧暦は日付で区切るので、一致しない日があります。
• 新月・満月などの時刻は、月と太陽の黄経の差（地心）が 0°・90°・180°・270° になる瞬間です。見る場所による違いや、月の出・月の入りは含みません。

干支と和暦

日の干支（kanshi）

十干（甲・乙・丙…）と十二支（子・丑・寅…）を組み合わせた60通りが、1日ずつ順に巡ります。1900年1月1日が甲戌（きのえいぬ）で、そこから途切れずに数えています。土用の丑の日の「丑」はこの十二支です。

年の干支（年の kanshi）

西暦の年で決め、1月1日で切り替えます（例: 2026年は丙午）。立春で年の干支を切り替える流儀（占いなどで使われます）もありますが、このAPIでは1月1日です。立春で切り替えたいときは、立春の日（solar_terms の「立春」）より前を前の年の干支として扱ってください。

和暦（wareki）

明治以降の元号で、元号の1年目は「元年」と書きます。元号は、切り替わった日から新しいものにしています。

• 1900年1月1日は明治33年です（このAPIの期間は明治33年から）。
• 未来の日付も、今の元号（令和）のまま数えています（2100年は令和82年）。改元がいつになるかは分からないためです。改元が決まったら、その日から新しい元号に直します。

正確さ（暦要項との照合）

天文の計算には、NASA ジェット推進研究所（JPL）が公開している天体暦 DE440s を、Python の skyfield で使っています。太陽の地心の視黄経と、月と太陽の黄経の差を計算し、二十四節気・雑節の角度や新月・満月などになる瞬間を秒まで求めてから、日本時間で日付を決めています。

この結果を、国立天文台が毎年公表している暦要項の2004年から2027年までの24年分と照らし合わせました。

• 暦要項の時刻は分までです。こちらの時刻を分に丸めて比べると、22件が1分ずれます。どれも秒がちょうど30秒前後で、四捨五入の境目に当たるものです。APIの at は秒まで返します。
• 旧暦・六曜には公式の基準が無いため、照らし合わせていません。決め方は上のとおりです。
• 遠い将来の値について: 地球の自転はわずかにゆらいでおり（ΔT）、将来の分は予測を含みます。おおむね2050年以降は、0時に近い時刻の二十四節気や新月が、実際には前後の日になる可能性があります。そうした日は旧暦の月の始まり・六曜もずれます。

使い方の例

どの例も、ブラウザの JavaScript（フレームワーク不要）で動きます。年のファイルは一度取ったら覚えておき、同じ年では呼び直しません。

その日の六曜を出す

const API = "https://api.shirugear.com/koyomi/v1/";
const years = new Map(); // 年のファイルは一度だけ取り、使い回す

function loadYear(year) {
  if (!years.has(year)) {
    const p = fetch(API + year + ".json").then((res) => {
      if (!res.ok) throw new Error("HTTP " + res.status);
      return res.json();
    });
    p.catch(() => years.delete(year)); // 失敗したら次は取り直す
    years.set(year, p);
  }
  return years.get(year);
}

// "2026-11-01" のような日付の暦（1日分）。範囲外の年は例外
async function koyomiOf(date) {
  const data = await loadYear(Number(date.slice(0, 4)));
  return data.days.find((d) => d.date === date);
}

const day = await koyomiOf("2026-11-01");
console.log(day.rokuyo);      // "赤口"
console.log(day.lunar.text);  // "9月22日"（旧暦）
console.log(day.moon_age);    // 21.5

大安の日を拾う（土日祝だけ）

祝日は祝日・営業日APIの同じ年のファイルから取り、日付で突き合わせます。上の loadYear を使います。

const [koyomi, holidays] = await Promise.all([
  loadYear(2026),
  fetch("https://api.shirugear.com/holidays/v1/2026.json").then((res) => res.json()),
]);
const holidayDates = new Set(holidays.holidays.map((h) => h.date));

const goodDays = koyomi.days.filter((d) =>
  d.rokuyo === "大安" && (d.weekday === "土" || d.weekday === "日" || holidayDates.has(d.date))
);
console.log(goodDays.map((d) => d.date));
// ["2026-01-01", "2026-01-24", "2026-02-11", "2026-02-21", …]

カレンダーに六曜を添える

日付のマスに data-date を付けておき、六曜を入れる場所を用意します。値は textContent で入れます（HTML として解釈させない）。

<!-- カレンダーの1マス（例） -->
<td data-date="2026-11-01">1 <small class="rokuyo"></small></td>

<script>
async function addRokuyo(root) {
  for (const cell of root.querySelectorAll("[data-date]")) {
    const label = cell.querySelector(".rokuyo");
    if (!label) continue;
    try {
      const day = await koyomiOf(cell.dataset.date); // 上の例の koyomiOf（年ごとに1回だけ通信）
      label.textContent = day ? day.rokuyo : "";
    } catch (e) {
      label.textContent = ""; // 取れなければ六曜なしで表示する
    }
  }
}
addRokuyo(document);
</script>

六曜が取れなくてもカレンダー自体は使えるように、六曜は「あれば添える」作りにしておくと安心です。

エラー

うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください（message は説明文で、言い回しが変わることがあります）。

{"error":{"status":404,"code":"year_not_found","message":"この年の暦はありません。1900年から2100年までで指定してください。"}}

通信できない・サーバーが止まっているときは、JSON が返らないことがあります。fetch の失敗（例外）も受け止めて、暦なしでも画面が使えるようにしてください。

データの更新・キャッシュ・呼び出し回数

• 作り方: 暦は前もって計算して、年ごとのファイルにしてあります。天文の計算結果（二十四節気・雑節の角度・新月などの時刻の表）はシルギアの手元で作って保管し、サーバーが毎日の確認（4:50 日本時間ごろ）でそこから組み立て直します。
• 中身が変わるとき: 天文の表を作り直したときや、改元・誤りの修正があったときだけです。それ以外は、何度組み立てても同じ暦になります。
• データの版（data_version）: 元データが変わった日付です（例: "2026-11-01"）。祝日・営業日APIと共通の版なので、祝日のデータが更新されたときは、暦の中身が同じでも版の日付が進みます。/koyomi/v1/meta.json には、作った日時（built_at・UTC）・期間・計算のもと・日数も入っています。
• キャッシュ: 応答は1日（エラーは1時間）キャッシュしてかまいません。暦の中身はめったに変わらないので、アプリの中に年のファイルを長く持っておいてもかまいません。ETag／Last-Modified に対応しているので、変わっていなければ 304 が返ります。
• 呼び出し回数の目安: 決まった上限はありませんが、1つの利用元から1秒あたり10回程度までにしてください。年のファイルは使い回して、日付ごと・画面を開くごとに同じ年を取り直さないでください。1年分のカレンダーなら、呼び出しは1回で済みます。
• 全期間をまとめて使いたいとき: 201年分（約20MB）を一度に取るような使い方は控え、必要な年だけを取ってください。

変更の方針と更新履歴

• v1 の中では、項目を足すことはあっても、今ある項目の名前や意味は変えません。知らない項目が増えていても無視するように作ってください。
• 計算の誤りを直したときや改元のときは、同じ v1 のまま値を直します。そのときはこのページの更新履歴でお知らせします。
• 互換性のない変更は、URLの版を分けて（/koyomi/v2/ など）行います。v1 を終わらせるときは、できるかぎり6か月以上前にこのページでお知らせします。
• 提供条件（無料・登録不要・アクセス回数の上限など）は、利用状況に応じて変えることがあります（利用規約第4条）。

更新履歴

2026年11月1日

公開。

機械で読める仕様（型定義・OpenAPI）

• TypeScript の型定義: /koyomi/types.d.ts
• OpenAPI 3.1: /koyomi/openapi.json（コード生成やテストに使えます）

用語の説明

よくある質問

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。六曜・干支などの暦注は迷信・慣習としての参考情報で、科学的な根拠を示すものではありません。公式の暦（二十四節気・朔弦望など）を確かめたいときは、国立天文台 暦計算室の暦要項をご覧ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。