和暦・元号API

明治・大正・昭和・平成・令和の元号の始まりと終わりの日と、1868年から2100年までの西暦の年に当たる和暦を返すAPIです。1989年(昭和64年・平成元年)のように年の途中で元号が変わる年は、両方の和暦とそれぞれの期間が分かります。明治5年(1872年)までの、旧暦による年の区切りにも対応しています。

できること
西暦の年から和暦を出す / 和暦から西暦を出す(計算式)/ 日付が和暦で何年か調べる / 元号の始まりと終わりの日・根拠の資料を取る
費用・登録
無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
向いている用途
申込書・届出の生年月日の和暦表示、和暦で入力された年の西暦への変換、年齢・年表・帳票の作成
気をつけること
明治以降の元号だけです(慶応以前は含みません)。令和は2100年まで今の元号のまま数えています。止まらないことは保証していません。

データ: 元号法・元号を改める政令・内閣府・国立公文書館・国立天文台の資料で確認(確認した日は /wareki/v1/meta.json の data_version で分かります。今は 2026-11-20)

はじめかた(3ステップ)

  1. ブラウザで開いてみる: https://api.shirugear.com/wareki/v1/2026.json を開くと、2026年の和暦(令和8年)が返ります。URLの数字を調べたい西暦の年(1868〜2100)に変えるだけです。
  2. 元号の一覧を取る: /wareki/v1/eras.json に、5つの元号の始まりと終わりの日と、和暦から西暦にするための offset が入っています。和暦の年に offset を足すと西暦になります(令和8年 = 8 + 2018 = 2026年)。
  3. 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。

いろいろな言語から呼ぶ

どの例も、1989年の和暦を出します(1989年は年の途中で昭和から平成に変わります)。

const res = await fetch("https://api.shirugear.com/wareki/v1/1989.json");
const y = await res.json();
console.log(y.wareki); // → 昭和64年・平成元年
for (const e of y.eras) console.log(e.label, e.from, "〜", e.to);
// → 昭和64年 1989-01-01 〜 1989-01-07
// → 平成元年 1989-01-08 〜 1989-12-31
curl -s https://api.shirugear.com/wareki/v1/1989.json

# 和暦の表記だけを出す(jq を使う場合)
curl -s https://api.shirugear.com/wareki/v1/1989.json | jq -r '.wareki'
<?php
$y = json_decode(file_get_contents('https://api.shirugear.com/wareki/v1/1989.json'), true);
echo $y['wareki'], "\n"; // 昭和64年・平成元年
foreach ($y['eras'] as $e) {
    echo "{$e['label']} {$e['from']}〜{$e['to']}\n";
}
import json
import urllib.request

url = "https://api.shirugear.com/wareki/v1/1989.json"
with urllib.request.urlopen(url, timeout=10) as res:
    y = json.load(res)
print(y["wareki"])  # 昭和64年・平成元年
for e in y["eras"]:
    print(e["label"], e["from"], "〜", e["to"])

その場で試す

西暦から和暦

試しに:

和暦期間(西暦)

和暦から西暦

元号ごとの各年(/wareki/v1/{元号}.json)を読み込み、その年が西暦のいつからいつまでかを出します。

URLの一覧

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

URL返すもの
/wareki/v1/eras.json5つの元号の始まりと終わりの日・最後の年・西暦にするための offset・根拠の資料。約3.6KB(通信は圧縮されて約1.4KB)。中身
/wareki/v1/{西暦4桁}.jsonその年に当たる和暦と、それぞれの期間。1868〜2100年。例: /wareki/v1/2019.json。1件 約0.2〜0.3KB。中身
/wareki/v1/{元号}.jsonその元号の各年が西暦のいつからいつまでか。元号は meiji・taisho・showa・heisei・reiwa。例: /wareki/v1/showa.json。約2〜10KB。中身
/wareki/v1/meta.jsonデータの版(確認した日)・範囲・件数・出典

元号の一覧(eras.json)

応答の例

GET https://api.shirugear.com/wareki/v1/eras.json

{
  "eras": [
    {
      "key": "meiji",
      "name": "明治",
      "kana": "めいじ",
      "romaji": "Meiji",
      "start": "1868-01-25",
      "end": "1912-07-29",
      "proclaimed": "1868-10-23",
      "last_year": 45,
      "offset": 1867,
      "basis": {
        "text": "明治元年9月8日(1868年10月23日)の改元の詔と行政官布告第726号で、慶応4年を明治元年に改め、一世一元と定めた。慶応4年1月1日は1868年1月25日。",
        "sources": [
          { "label": "国立公文書館「一世一元の制となる」", "url": "https://www.archives.go.jp/ayumi/kobetsu/m01_1868_04.html" },
          …
        ]
      }
    },
    …
    {
      "key": "reiwa",
      "name": "令和",
      "kana": "れいわ",
      "romaji": "Reiwa",
      "start": "2019-05-01",
      "end": null,
      "proclaimed": "2019-04-01",
      "last_year": null,
      "offset": 2018,
      "basis": { "text": "元号を改める政令(平成31年政令第143号)。2019年4月1日公布、5月1日施行。", "sources": [ … ] }
    }
  ],
  "note": "西暦 = 和暦の年 + offset(例: 令和8年 = 8 + 2018 = 2026年)。…",
  "data_version": "2026-11-20"
}

各項目(eras の1件)

項目型内容
key文字列元号の英字の名前(URLに入れる名前)。"meiji"・"taisho"・"showa"・"heisei"・"reiwa"
name・kana・romaji文字列元号(例: 「令和」)・読み(ひらがな)・ローマ字
start文字列その元号の最初の日("YYYY-MM-DD"・グレゴリオ暦)。この日が元年の始まりです
end文字列 または nullその元号の最後の日。今の元号(令和)は null
proclaimed文字列改元を定めた日(改元の詔・詔書の日、または元号を改める政令の公布日)。start と違う日のことがあります(元号の境目の日)
last_year数値 または null最後の年(例: 昭和は 64)。令和は null
offset数値和暦の年に足すと西暦になる数(西暦 = 和暦の年 + offset)
basisオブジェクト境目の日の根拠。text(説明)と sources(資料の label・url)

そのほか、note(変換の説明)と data_version(データの版)があります。

西暦の年ごと

応答の例

GET https://api.shirugear.com/wareki/v1/1989.json

{
  "year": 1989,
  "wareki": "昭和64年・平成元年",
  "eras": [
    { "era": "昭和", "key": "showa", "year": 64, "label": "昭和64年", "from": "1989-01-01", "to": "1989-01-07" },
    { "era": "平成", "key": "heisei", "year": 1, "label": "平成元年", "from": "1989-01-08", "to": "1989-12-31" }
  ],
  "lunar_calendar": false,
  "data_version": "2026-11-20"
}

各項目

項目型内容
year数値西暦の年
wareki文字列和暦の年(例: 「令和8年」)。1年目は「元年」と書きます。年の途中で和暦の年が変わるときは、両方を「・」でつなぎます(例: 「昭和64年・平成元年」)
eras配列その年にある和暦の年を、早い順に。era(元号)・key(元号の英字の名前)・year(和暦の年。元年は 1)・label(「平成元年」などの表記)・from・to(その西暦の年の中での期間 "YYYY-MM-DD")
lunar_calendar真偽値旧暦を使っていた年か(1868〜1872年は true)。明治5年までの旧暦
note文字列(ない年もあります)注意書き。1868〜1872年だけにあります
data_version文字列データの版(資料と照らし合わせた日 "YYYY-MM-DD")

eras の期間は、その西暦の年の中だけです。1989年の昭和64年は「1989-01-01〜1989-01-07」で、昭和64年がこの7日間だけだったことが分かります。

元号ごとの各年

応答の例

GET https://api.shirugear.com/wareki/v1/meiji.json

{
  "era": { "key": "meiji", "name": "明治", … },
  "years": [
    { "year": 1, "label": "明治元年", "seireki": 1868, "from": "1868-01-25", "to": "1869-02-10", "lunar_calendar": true },
    { "year": 2, "label": "明治2年", "seireki": 1869, "from": "1869-02-11", "to": "1870-01-31", "lunar_calendar": true },
    …
    { "year": 6, "label": "明治6年", "seireki": 1873, "from": "1873-01-01", "to": "1873-12-31", "lunar_calendar": false },
    …
    { "year": 45, "label": "明治45年", "seireki": 1912, "from": "1912-01-01", "to": "1912-07-29", "lunar_calendar": false }
  ],
  "data_version": "2026-11-20"
}
項目型内容
eraオブジェクトその元号の情報(eras.json の1件と同じ)
years配列和暦の各年を順に。year(元年は 1)・label・seireki(その年が始まった西暦の年)・from・to(その和暦の年の最初の日と最後の日)・lunar_calendar(旧暦の年か)
data_version文字列データの版

令和は、2100年に当たる令和82年まで入っています。

/wareki/v1/meta.json

項目内容
data_version・checked_at資料と照らし合わせた日("YYYY-MM-DD")
range西暦の年の範囲(from: 1868・to: 2100)
scope入っている範囲の説明
eras元号(key)の一覧
counts件数(eras=元号の数 5・years=西暦の年の数 233)
sources資料(label・url)

元号の境目の日

元号始まった日(start)終わった日(end)改元を定めた日(proclaimed)offset
明治1868年1月25日1912年7月29日(明治45年)1868年10月23日1867
大正1912年7月30日1926年12月24日(大正15年)1912年7月30日1911
昭和1926年12月25日1989年1月7日(昭和64年)1926年12月25日1925
平成1989年1月8日2019年4月30日(平成31年)1989年1月7日1988
令和2019年5月1日(今の元号)2019年4月1日2018

境目の日は、シルギアの暦API・和暦・西暦変換と同じです。

明治5年までの旧暦

日本は明治5年(1872年)まで旧暦(天保暦)を使っていました。そのため、明治元年から明治5年までは、和暦の年の区切りが西暦の1月1日ではなく、旧暦の元日です。旧暦の明治5年12月2日(1872年12月31日)の翌日を明治6年1月1日(1873年1月1日)として、今の暦に改めました。

和暦期間(西暦)
明治元年1868年1月25日〜1869年2月10日
明治2年1869年2月11日〜1870年1月31日
明治3年1870年2月1日〜1871年2月18日
明治4年1871年2月19日〜1872年2月8日
明治5年1872年2月9日〜1872年12月31日
明治6年1873年1月1日〜(ここから西暦と同じ1月1日始まり)

和暦と西暦の変換

和暦の年から西暦の年

和暦の年に、その元号の offset を足します。元年は 1 として計算します。

const { eras } = await (await fetch("https://api.shirugear.com/wareki/v1/eras.json")).json();
const byKey = Object.fromEntries(eras.map((e) => [e.key, e]));

/** 元号(key)と和暦の年から西暦の年。その元号に無い年なら null */
function toSeireki(key, year) {
  const e = byKey[key];
  if (!e || year < 1 || (e.last_year !== null && year > e.last_year)) return null;
  return year + e.offset;
}

console.log(toSeireki("reiwa", 8));   // → 2026
console.log(toSeireki("showa", 64));  // → 1989
console.log(toSeireki("heisei", 1));  // → 1989
console.log(toSeireki("taisho", 16)); // → null(大正は15年まで)

日付から和暦

その日付がある年の応答(/wareki/v1/{西暦}.json)で、eras からfrom 〜 to にその日付が入るものを選びます。日付は "YYYY-MM-DD" の文字列のまま比べられます。明治5年までの旧暦の年の区切りも、この方法なら正しく出ます。

/** "YYYY-MM-DD" → "平成元年" など */
async function warekiOf(date) {
  const y = await (await fetch(`https://api.shirugear.com/wareki/v1/${date.slice(0, 4)}.json`)).json();
  const e = y.eras.find((x) => x.from <= date && date <= x.to);
  return e ? e.label : null;
}

console.log(await warekiOf("1989-01-07")); // → 昭和64年
console.log(await warekiOf("1989-01-08")); // → 平成元年
console.log(await warekiOf("1869-02-10")); // → 明治元年(旧暦の元日の前日)

日付を和暦の月日まで表したいとき(「令和8年11月20日」)は、明治6年以降なら月日は西暦と同じです。

暦APIとの使い分け

暦APIにも、日ごとの和暦の年の表記(wareki)があります。

エラー

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

{"error":{"status":404,"code":"year_not_found","message":"この年はありません。和暦・元号 API の範囲は1868〜2100年(明治元年〜令和82年)です。"}}
状態codeいつ
400invalid_pathURLの形が違う(2桁の年・和暦・一覧に無い元号の名前 など。例: /wareki/v1/26.json・/wareki/v1/Reiwa.json)
403region_not_allowed日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます)
404year_not_found範囲外の年(1868年より前・2100年より後。例: /wareki/v1/1867.json)
405method_not_allowedGET / HEAD 以外で呼んだ

データの根拠・更新・キャッシュ

変更の方針と更新履歴

更新履歴

2026年11月20日
公開。

機械で読める仕様(型定義・OpenAPI)

このデータを使っているツール

シルギアの次のツールは、このAPIと同じデータで動いています。APIの答えを画面で確かめたいときや、使い方のイメージをつかみたいときにどうぞ。

このAPIと同じデータから作ったツール

よくある質問

本当に無料ですか?登録は必要ですか?

現在は無料で、登録やAPIキーも要りません。個人・法人、営利・非営利を問わず使えます。ただし利用状況に応じて提供条件を変えることがあり、そのときはできるかぎりこのページでお知らせします。

和暦から西暦にするには?

eras.json の offset を和暦の年に足します。令和8年なら 8 + 2018 = 2026年です。元年は1として計算します。和暦と西暦の変換にコードの例があります。

1989年1月7日は昭和ですか、平成ですか?

昭和64年です。平成は、元号を改める政令が施行された1989年1月8日からです。政令が公布されたのは1月7日ですが、その日はまだ昭和です。

令和の次の元号になったら、どうなりますか?

今は次の元号が決まっていないため、2100年まで令和のまま数えています(2100年は令和82年)。改元が決まったら、その日から新しい元号に直します。

慶応や江戸時代の元号は入っていますか?

入っていません。このAPIは明治以降の元号(1868年1月25日から)だけです。

画面で和暦と西暦を変換したいときは?

シルギアの和暦・西暦変換をお使いください。元号の境目の日は、このAPIと同じです。

アクセス数に上限はありますか?

決まった上限はありませんが、目安として1つの利用元から1秒あたり10回程度までにしてください。元号の情報はめったに変わらないので、取ったデータは使い回してください。

ご利用にあたって

ご利用の前に利用規約をご確認ください。データの正確さや、止まらないことは保証していません。元号の公式の情報は、内閣府「元号について」などでご確認ください。ご質問・不具合のご連絡は、シルギアのお問い合わせ窓口から、件名に「API」と入れてお送りください。