和暦・元号API
明治・大正・昭和・平成・令和の元号の始まりと終わりの日と、1868年から2100年までの西暦の年に当たる和暦を返すAPIです。1989年(昭和64年・平成元年)のように年の途中で元号が変わる年は、両方の和暦とそれぞれの期間が分かります。明治5年(1872年)までの、旧暦による年の区切りにも対応しています。
- できること
- 西暦の年から和暦を出す / 和暦から西暦を出す(計算式)/ 日付が和暦で何年か調べる / 元号の始まりと終わりの日・根拠の資料を取る
- 費用・登録
- 無料・登録不要・APIキー不要(提供条件は利用状況で変わることがあります)
- 向いている用途
- 申込書・届出の生年月日の和暦表示、和暦で入力された年の西暦への変換、年齢・年表・帳票の作成
- 気をつけること
- 明治以降の元号だけです(慶応以前は含みません)。令和は2100年まで今の元号のまま数えています。止まらないことは保証していません。
データ: 元号法・元号を改める政令・内閣府・国立公文書館・国立天文台の資料で確認(確認した日は /wareki/v1/meta.json の data_version で分かります。今は 2026-11-20)
はじめかた(3ステップ)
- ブラウザで開いてみる: https://api.shirugear.com/wareki/v1/2026.json を開くと、2026年の和暦(令和8年)が返ります。URLの数字を調べたい西暦の年(1868〜2100)に変えるだけです。
- 元号の一覧を取る:
/wareki/v1/eras.jsonに、5つの元号の始まりと終わりの日と、和暦から西暦にするためのoffsetが入っています。和暦の年にoffsetを足すと西暦になります(令和8年 = 8 + 2018 = 2026年)。 - 利用規約を確かめる: 利用規約をご確認ください。登録や申し込みは要りません。
いろいろな言語から呼ぶ
どの例も、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-31curl -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.json | 5つの元号の始まりと終わりの日・最後の年・西暦にするための 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 | データの版(確認した日)・範囲・件数・出典 |
- 年は半角数字4桁の西暦で指定します(
2026)。範囲外の年(/wareki/v1/1867.jsonなど)は 404、和暦や2桁の年・上の一覧に無い元号の名前など、URLの形が違うものは 400 です。 - 呼び出しは
GET(またはHEAD)だけです。独自のヘッダを付けずに呼んでください。
元号の一覧(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 |
- 大正・昭和は、改元の当日から新しい元号です。改元の詔書で「同日以後」を新しい元号の元年としたため、1912年7月30日は大正元年、1926年12月25日は昭和元年です。
- 平成・令和は、元号を改める政令の施行日からです。平成は公布(1989年1月7日)の翌日の1月8日から、令和は2019年4月1日の公布のあと、5月1日からです。1989年1月7日は昭和64年、2019年4月30日は平成31年です。
- 明治は、さかのぼってその年の元日から明治元年としました。改元の詔は明治元年9月8日(1868年10月23日)ですが、慶応4年を明治元年に改めたため、慶応4年1月1日(1868年1月25日)が明治の始まりです。
proclaimed(1868-10-23)とstart(1868-01-25)が違うのはこのためです。1868年1月24日までは慶応3年で、この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日始まり) |
- このため、1869年〜1872年の西暦の年ごとの応答には、和暦の年が2つ入ります。たとえば
/wareki/v1/1869.jsonは「明治元年」(1869年1月1日〜2月10日)と「明治2年」(2月11日〜)です。 - 1868〜1872年は
lunar_calendarがtrueで、注意書き(note)が付きます。この期間は、和暦の月日(例: 明治元年9月8日)と西暦の月日が一致しません。和暦の月日を西暦の日付にするには、旧暦の日付の換算が必要です(国立天文台「日本の暦日データベース」などで確かめられます)。
和暦と西暦の変換
和暦の年から西暦の年
和暦の年に、その元号の 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年まで)
- 明治5年までは、和暦の年が西暦の年をまたぎます(明治元年は1868年1月25日〜1869年2月10日)。
offsetで出るのは「その和暦の年が始まった西暦の年」です。期間まで要るときは、元号ごとの各年(/wareki/v1/meiji.json)のfrom・toを見てください。
日付から和暦
その日付がある年の応答(/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)があります。
- 日ごとの六曜・旧暦・二十四節気なども要るなら暦APIです(1900〜2100年)。
- 元号の境目の日や、和暦から西暦への変換ならこのAPIです。元号の一覧と根拠の資料や、明治の初め(1868〜1872年)にあった、旧暦による年の区切りも分かります。
エラー
うまくいかないときは、HTTPの状態コードと、次の形の JSON を返します。code は固定の値なので、プログラムで見分けるときはこれを使ってください(message は説明文で、言い回しが変わることがあります)。
{"error":{"status":404,"code":"year_not_found","message":"この年はありません。和暦・元号 API の範囲は1868〜2100年(明治元年〜令和82年)です。"}}
| 状態 | code | いつ |
|---|---|---|
| 400 | invalid_path | URLの形が違う(2桁の年・和暦・一覧に無い元号の名前 など。例: /wareki/v1/26.json・/wareki/v1/Reiwa.json) |
| 403 | region_not_allowed | 日本国内以外から呼んだ(データは日本国内からのアクセスに限っています。説明ページは海外からも見られます) |
| 404 | year_not_found | 範囲外の年(1868年より前・2100年より後。例: /wareki/v1/1867.json) |
| 405 | method_not_allowed | GET / HEAD 以外で呼んだ |
データの根拠・更新・キャッシュ
- 根拠: 境目の日は、次の資料で確かめています。元号ごとの資料は
eras.jsonのbasisにあります。- 元号法(昭和54年法律第43号)
- 元号を改める政令(昭和64年政令第1号・平成31年政令第143号)
- 内閣府「元号について」
- 国立公文書館「一世一元の制となる」「大正と改元」「昭和と改元」
- 改暦ノ布告(明治5年太政官布告第337号)
- 国立天文台 暦計算室「日本の暦日データベース」(明治元年〜5年の旧暦の元日の換算)
- 国立国会図書館 電子展示会「日本の暦」
- 範囲: 明治以降の元号(明治・大正・昭和・平成・令和)と、1868〜2100年です。慶応以前の元号は含みません。
- 令和のあと: 次の元号は決まっていないため、2100年まで令和のまま数えています(2100年は令和82年)。改元が決まったら、その日から新しい元号に直し、このページでお知らせします。
- データの版(
data_version): 資料と照らし合わせた日です(今は 2026-11-20)。 - キャッシュ: 応答は1日(エラーは1時間)キャッシュしてかまいません。
ETag/Last-Modifiedに対応しているので、変わっていなければ 304 が返ります。中身はめったに変わらないので、eras.jsonを1回取って使い回すのがおすすめです。 - 呼び出し回数の目安: 決まった上限はありませんが、1つの利用元から1秒あたり10回程度までにしてください。
変更の方針と更新履歴
- v1 の中では、項目や元号を追加することはあっても、今ある項目の名前や意味は変えません。知らない項目・元号が増えていても無視するように作ってください。改元があったときは、元号を追加し、令和の
end・last_yearと、その日より後の年の和暦を直します。 - 互換性のない変更は、URLの版を分けて(
/wareki/v2/など)行います。v1 を終わらせるときは、できるかぎり6か月以上前にこのページでお知らせします。 - 提供条件(無料・登録不要・アクセス回数の上限など)は、利用状況に応じて変えることがあります(利用規約第4条)。
更新履歴
- 2026年11月20日
- 公開。
機械で読める仕様(型定義・OpenAPI)
- TypeScript の型定義:
/wareki/types.d.ts - OpenAPI 3.1:
/wareki/openapi.json
このデータを使っているツール
シルギアの次のツールは、この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」と入れてお送りください。