ForHosting KIT · 日付・時間

中国の干支・五行計算

Q: 中国の正月は考慮されますか？

いいえ。 入力は名目上のグレゴリオ暦年のみです。1月や2月初旬生まれは前の中国太陰年に属することがあるため、その境界には太陰太陽暦コンバータを使ってください。

2024年は甲辰（陽の木の竜）で、1984年の甲子（木の鼠）から始まる60年周期の41番目です。年を入れるだけで、動物、五行、陰陽、周期の中の位置が分かります。ブラウザで無料で使えます。

無料
ブラウザで動作
登録不要
データは端末の外に出ません

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算例

入力した場合

年: 2,024

結果

生肖: Dragon
五行: Wood
陰陽: yang
天干インデックス: 0

中国の十二支は十二の動物の一覧だけではありません。毎年にはさらに五行（木・火・土・金・水）の属性が付き、伝統的な六十干支の天干と地支のサイクルに織り込まれています。木の龍、火の馬、金の鼠という言い方は、十二支の動物に、十干の系列からの五行と陰陽の極性を組み合わせたものです。この計算ツールはグレゴリオ暦の年を整数一つ受け取り、動物、五行、極性、干支のピンイン表記、六十干支の複合名、サイクル内の1から60の位置を返します。写像は標準の先発的公式で、1984年がJia-Zi、すなわち現代の六十年周期を開く陽の木の鼠になるよう固定されています。非整数の年は黙った丸めではなく、明確な検証エラーで拒否されます。

60年の動物と五行のサイクルの仕組み

伝統暦における中国の年のラベルは、二つの独立した周期を組み合わせます。地支は固定順の十二動物—鼠・牛・虎・兎・龍・蛇・馬・羊・猿・鶏・犬・猪—を巡ります。天干は五行と陰陽の極性を符号化する十の位置を巡ります。

JiaとYiは木、BingとDingは火、WuとJiは土、GengとXinは金、RenとGuiは水。偶数の干インデックスは陽、奇数は陰です。十二と十の最小公倍数は六十なので、固有の干支の組は六十年後にだけ繰り返します。

歴史的紀年、占い、文化的な年名に今も使われる六十干支です。ここで使う計算写像は、支インデックス＝年−4を12で割った余り、干インデックス＝年−4を10で割った余り、サイクル位置＝年−4を60で割った余り＋1です。この規約では1984年はサイクル位置1、Jia-Zi、陽の木の鼠。

2024年はJia-Chen、陽の木の龍。2020年はGeng-Zi、陽の金の鼠です。アルゴリズムは整数年に対する純粋なモジュラ算術で、壁時計も乱数シードもネットワーク呼び出しも浮動小数のドリフトもありません。

負の年も、実装が正の剰余を使うため先発的サイクルが歴史研究のために後方へ続き、例外を投げません。この年のみのツールが意図的にしないのは、中国の正月での境界ずらしです。1月や2月初旬の誕生日に正確な太陰太陽暦の切り替わりが必要なら、別の検索意図とランディングである太陰太陽暦コンバータが必要です。

中国の干支・五行参照が実務で現れる場面

編集・マーケチームは太陰正月キャンペーンを数か月前から計画し、市場年ごとの信頼できる動物＋五行の文面を、十年ごとにずれる手作業の表なしで必要とします。東アジア史や文化研究を教える教育者は六十干支の紀年演習を出し、教科書と照合できるよう一般的な動物名と正式な干支複合の両方を返す単一の神託を求めます。

系譜・家族史ツールは西洋と中国の混在ソースから生年を保存し、タイムライン構築や転写文書の検証で年→ラベルの決定的マップの恩恵を受けます。ゲームデザイナー、小説家、アプリ開発者がキャラ背景や年次イベントのテーマを作るとき、動物の字形だけでなく火の馬対水の馬といった五行の味わいがしばしば必要です。

後で精密な生年月日時からの四柱推命、西洋太陽星座占星、グレゴリオ年内の通日序数が必要なら、この年ベースの中国干支・五行計算機に積み込まず、別の検索意図とランディングとして扱ってください。

活用例

太陰正月キャンペーンの文面

中国の正月キャンペーン前に、商品ページ・メール・SNS向けに正しい動物と五行の年名を生成します。

教室での六十干支ドリル

任意の年について動物・干支ピンイン・サイクル位置を生徒に渡し、宿題の正答が単一の決定的神託と一致するようにします。

系譜とタイムラインのラベル

家族史や歴史タイムラインを作るとき、生年と出来事の年に伝統的な中国の年名（五行＋動物）を注釈します。

よくある質問

年からの中国の生肖はどう計算しますか？

地支インデックスは（年−4）を12で割った余りで、0〜11を鼠から猪に対応づけます。例：2024は支インデックス4で龍です。

五行の組み合わせはどう決まりますか？

天干インデックスは（年−4）を10で割った余りです。干は対で木・火・土・金・水に写像され、偶数インデックスは陽、奇数は陰です。

60年の六十干支とは何ですか？

12の動物と10の干の最小公倍数です。各固有の干支の組（例：Jia-Chen）は60年ごとに繰り返します。本ツールの位置1は1984年、Jia-Ziの木の鼠です。

中国の正月は考慮されますか？

いいえ。入力は名目上のグレゴリオ暦年のみです。1月や2月初旬生まれは前の中国太陰年に属することがあるため、その境界には太陰太陽暦コンバータを使ってください。

同じ辰年でも五行が違うのはなぜですか？

五行は10年、動物は12年の周期で回るためです。2000年は陽の金の竜、2012年は陽の水の竜、2024年は陽の木の竜になります。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/date/chinese-zodiac-element

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/date/chinese-zodiac-element \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2024}'

const res = await fetch("https://api.kit.forhosting.com/date/chinese-zodiac-element", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "year": 2024
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/chinese-zodiac-element",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "year": 2024
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/chinese-zodiac-element", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"year":2024}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"year":2024}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/chinese-zodiac-element", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "year": 2024
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.chinese_zodiac_element",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

技術的な注記

無料のブラウザツールと有料APIは一つの純粋な同型関数を共有するため、授業デモ、系譜メモ、自動フィクスチャが同じ年で食い違うことはありません。

送る内容と返ってくる内容

成功時、応答はyearを返し、animalを十二の英語の動物名の一つ、elementをWood・Fire・Earth・Metal・Waterの一つ、polarityをyinまたはyangとして返します。古典的な健全性チェックには、1984年がサイクル位置1のYang Wood Rat、2000年がYang Metal Dragon、2012年がYang Water Dragon、2025年がYin Wood Oxなどがあります。個人や教室の素早い確認には無料ブラウザフォームを配線し、年の一括表、年次キャンペーンの商品文、系譜ソフトの回帰フィクスチャが必要なときはスクリプトから同一契約を呼んでください。必須フィールドyearにグレゴリオ暦の年を整数で送ってください（例：2024）。きれいに整数として解釈できる数字文字列は受け付け、分数、空文字、真偽値、非数値テキストはinvalid_inputで失敗し課金されません。プログラム用の0始まりのstem_indexとbranch_index、JiaやChenのような伝統ラベル用のstem_pinyinとbranch_pinyin、ハイフン付き干支名のsexagenary、1〜60のcycle_position、常に60のcycle_length、Yang Wood Dragonのような可読ラベル、写像をソースを読まずに監査できる短いformula文字列も返します。成功したAPI呼び出しの料金は公開ベースの$0.002/itemで、検証失敗はプリペイド残高を消費しません。

技術的な質問

料金はいくらですか？

ブラウザツールは無料でローカル実行です。APIリクエストは成功itemあたり$0.002でプリペイドKIT残高を使い、無効な入力は課金されません。

KITの完全なドキュメントを見る →