主体年と西暦の変換
西暦と主体年を相互に換算します。2024年は主体113年です。年だけでも日付でも入力でき、主体年から西暦の年に戻すこともできます。ブラウザで無料で使えます。
- 無料
- ブラウザで動作
- 登録不要
- データは端末の外に出ません
無料で実行
計算例
- 変換方向
- gregorian_to_juche
- 年
- 2,024
- グレゴリオ暦の年
- 2,024
- 主体年
- 113
グレゴリオ年または日付を主体年へ、またその逆へ決定的な純関数で変換します。端末内で完結し、アカウント不要でそのまま使えます。
主体年の数え方
主体暦では西暦千九百十二年を主体1年とし、それ以降の年はすべて千九百十一という同じ差で並びます。そのため換算は引き算1回で済み、2024から千九百十一を引くと主体113年になります。逆方向は足し算1回です。主体0年やマイナスの主体年はなく、数え方は1から始まって前に進むだけです。年だけを入力しても、日付を入力してもかまいません。日付の場合は年だけを使うので、2024年のどの日を入れても主体113年になります。
役立つ場面とよくある間違い
図書館やレファレンスの窓口では、出版物に書かれた主体年を西暦に直し、読者がなじみのある年表の上で出来事を確かめられるようにする場面があります。表計算で年表を管理する場合も、毎回同じ数字が得られることが大切です。よくある間違いは、千九百十一ではなく千九百十二を引いてしまい、答えが1年ずれることです。また、主体年から西暦に戻しても分かるのは年だけで、月や日は出ません。千九百十二年より前の年や小数の値は受け付けないため、入力ミスが誤った主体年になることはありません。
主体紀元のオフセット
主体暦は一九一二年を元年とするため、整数写像はグレゴリオ年から一九一一年を引くだけです。主体年が一未満になる値は紀元前として拒否されます。
活用例
レファレンス
公開された主体年を読者向けのグレゴリオ年に直します。
自動化
時系列を正規化するスクリプトから同じ純関数を呼びます。
よくある質問
無料ですか？
はい。 Tier A はブラウザだけで動き、アカウントは不要です。
西暦の年を主体年に換算するには？
西暦の年から千九百十一を引きます。主体暦は西暦千九百十二年を主体1年として数えるため、それ以降の年はすべて同じ差になります。
年の代わりに日付を入力できますか？
はい。年-月-日の形で日付を入力すると、その年を使って換算します。月や日は結果に影響しません。入力した日付は答えの横に再び表示されます。
主体年から西暦に戻すと日付も分かりますか？
いいえ。主体年から西暦への換算で分かるのは年だけです。主体年の数字には月や日の情報が含まれないためです。主体年は1以上の整数で入力します。
千九百十二年より前の年はどうなりますか？
受け付けません。主体年が1より小さくなりますが、数え方は主体1年から始まるため、そのような年は存在しません。小数の年も受け付けません。
関連ツール
開発者向け — APIアクセス
このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。
エンドポイント
Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。
お使いのスタックから呼び出す
curl -X POST https://api.kit.forhosting.com/date/juche \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"direction":"gregorian_to_juche","year":2024}'const res = await fetch("https://api.kit.forhosting.com/date/juche", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"direction": "gregorian_to_juche",
"year": 2024
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/date/juche",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"direction": "gregorian_to_juche",
"year": 2024
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/juche", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"direction":"gregorian_to_juche","year":2024}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"direction":"gregorian_to_juche","year":2024}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/juche", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)リクエスト例
{
"direction": "gregorian_to_juche",
"year": 2024
}レスポンス例
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "date.juche",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。
料金
単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。
エラー
| HTTP | コード | 意味 |
|---|---|---|
401 | unauthorized | APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。 |
402 | insufficient_balance | 残高が不足しています。チャージ後に再度お試しください。 |
404 | unknown_type | 指定されたタスクタイプは存在しません。タイプ名を確認してください。 |
429 | rate_limited | リクエストが多すぎます。しばらく待ってから再度お試しください。 |
技術的な注記
主体紀元のオフセット
方向 gregorian_to_juche は整数の year か YYYY-MM-DD 形式の date を受け付け、date がある場合は先頭四文字から年を取ります。成功ペイロードは direction・gregorian_year・juche_year と、入力された場合の date を返し、両入力様式でUIバインドが安定します。
逆変換と検証
任意の date は順方向で存在した場合のみエコーされ、逆モードは暦日を捏造しません。方向 juche_to_gregorian は一以上の整数 juche_year を要求し、gregorian_year を juche_year に一九一一年を足した値として返します。year と date の同時欠落、非整数、未知の方向文字列は安定した英語メッセージの invalid_input になります。現代グレゴリオ年・主体年からの逆変換・エラー経路の黄金例があり、クライアントはフィールド名を推測しなくて済みます。
決定性・限界・組み込み
実装はネットワークも時計も乱数も使わない純パース算術なので、同じ入力は常に同じ出力になります。世紀規模の値を保存する場合はその契約を文書化してください。極端に大きな年はプラットフォーム数値型が溢れるまで通常のIEEE整数です。メトリクスを繋ぐ前に direction・year・juche_year・date のスキーマを確認し、文書化された成功キーだけをバインドしてください。
連携の活用例
教材デモ
無料ウィジェットと同じ黄金例で単純オフセットを示します。
技術的な質問
通信しますか？
いいえ。パースエンジンは端末内で完結します。
入力が不正なときは？
明確な英語メッセージ付きの invalid_input を返します。
結果は安定しますか？
はい。決定的計算と黄金例が契約を固定します。
作者は誰ですか？
ForHosting KIT 工房の Aspire です。