ForHosting KIT · 日付・時間

中国式干支計算

2024年は辰(竜)年ですが、2024年2月9日生まれはまだ卯(兎)年です。動物は1月1日ではなく旧正月で切り替わるためです。年か日付を入れると正しい動物が分かります。ブラウザで無料で使えます。

  • 無料
  • ブラウザで動作
  • 登録不要
  • データは端末の外に出ません
ご利用方法 ウェブAPIメールTelegramアプリ 近日
入力した場合
年
2,024
結果
動物
Dragon
動物インデックス
4
サイクル位置
5
干支年
2,024

この中国式干支計算ツールは、西暦の年を受け取り、中国の太陰太陽暦のサイクルにおけるその年に対応する伝統的な十二支の動物、すなわち子・丑・寅・卯・辰・巳・午・未・申・酉・戌・亥のいずれかを返します。年だけを指定した場合、マッピングは「2024年は辰年」という人々が使う標準的な市民暦のラベルに従い、インデックス=(年-4)を12で割った余りという閉じた式で計算されます。1月下旬から2月上旬にかけての微妙な時期には、月日も渡すことでエンジンが旧正月のカットオフを適用できます。その年の旧正月より前の日付は前の動物に属します。既知の検証例として、2020年は子、2024年は辰、2024年2月9日は卯である一方、2024年2月10日は辰になります。エンジンは有限の算術と純粋な太陰太陽暦の新月計算のみを使用し、ネットワーク通信もサンプリングもホストの時計に基づくDateオブジェクトも使いません。

干支の動物の意味と結果の内容

中国式干支は、伝統的な東アジアの太陰太陽暦において各年にラベルを付ける12年周期の動物のサイクルです。日常会話では「2025年は巳年」のように市民暦の西暦年に1つの動物を結び付けますが、系図や文化研究を丁寧に行う場合は、動物が実際に切り替わるのは1月1日ではなく1月下旬から2月中旬の間に訪れる旧正月であることも尊重します。

リモートの天体暦をダウンロードすることも、伝承をランダムにサンプリングすることもありません。西洋の太陽星座、時刻に基づく十二支の時辰、五行の干支表は意図的に対象外です。イースターの日付、ISO週番号、一般的な日付計算が必要な場合はそれぞれの専用ツールをご利用ください。

このページは、検証済みの年と任意のカットオフ日付に対する中国式干支の動物のみに答えます。

年月日の入れ方と旧正月の境目

先頭に任意のプラスまたはマイナス記号を持つ数値文字列は、整数として解析できる場合に受け付けられ、小数点、指数表記、16進数プレフィックス、空文字列は明確なメッセージとともに拒否されるため、不正なセルが誤った動物につながることはありません。解析後、カタログ内の他のカレンダーヘルパーに合わせ、yearは1から9999の間でなければなりません。

任意のmonthとdayは必ず両方一緒に指定する必要があり、monthの別名にはm、大文字のM、mon、dayの別名にはd、大文字のD、domがあり、いずれも妥当な範囲の整数として、グレゴリオ暦のうるう2月を含むその月の実際の長さに対してdayが検証されます。

monthとdayが指定された場合、エンジンはJavaScriptのDateオブジェクトを一切呼び出すことなく、UTCから東に8時間の中国標準時における純粋な儒略日と新月の算術を用いて、その市民暦年の旧正月を計算します。旧正月当日以降は市民暦年がそのまま動物を保ちます。

中国式干支のルックアップが文化・製品・ソフトウェアで役立つ場面

季節のコピーを書く編集者やマーケターは、キャンペーンをまたいで見出しやアセット名を一貫させるために、年から動物への安定したマッピングを必要とします。系図・文化教育系のプロダクトは、旧正月付近の誕生日がサイレントに誤った干支を引き継がないよう、任意の日付経路を求めます。

開発者は同じ契約をスクリプトから呼び出し、ローカライゼーションテーブルの種を作ったり、プロフィールバッジ用の決定的なテストベクターを生成したり、時代遅れになるハードコードされた一覧ではなく文書化された式を要求する製品要件を満たしたりします。

教師はこのツールを使って、12年の剰余サイクルと移動する旧正月がどう相互作用するかを示し、互いに食い違う不透明な電卓アプリに頼ることなく1月・2月の境界日を実演します。旧正月プロモーションを構築するイベントプランナーやホスピタリティチームは、資料を印刷する前に特定の市民暦日にどの動物が該当するかを確認できます。

このページでの計算はすべてブラウザ内で完結します。教育、コンプライアンス、製品機能向けにカレンダーユーティリティの小さなラボを構築する際は、他の無料の決定的な日付ヘルパーと組み合わせてご利用ください。

その年の動物ラベル

標準的な剰余サイクルを用いて、任意の西暦年を子から亥にマッピングし、記事、キャンペーン名、UIバッジに活用できます。

旧正月付近の誕生日

monthとdayを渡すことで、旧正月より前の日付が市民暦年のラベルではなく前の動物として解決されます。

年だけから動物はどのように選ばれますか?

index=((年-4) mod 12 + 12) mod 12で、子=0から亥=11までです。たとえば2020年は子、2024年は辰です。

monthとdayも送信するとどうなりますか?

エンジンはその年の旧正月を計算します。旧正月より厳密に前の日付は前の干支年を使い、旧正月当日以降は市民暦年の動物を保ちます。

西洋占星術の星座は返されますか?

いいえ。 年(および任意の旧正月カットオフ日付)に対する中国式十二支のみを返します。

中国の十二支の動物はどんな順番ですか?

鼠、牛、虎、兎、竜、蛇、馬、羊、猿、鶏、犬、豚の順です。12年ごとに一巡するため、2020年は鼠、2024年は5番目の竜になります。

どの年の干支まで調べられますか?

1年から9999年までの年を調べられます。日付も入れる場合は、うるう年の2月を含め、その月に実在する日かどうかを確かめてから判定します。

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

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

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

curl -X POST https://api.kit.forhosting.com/date/chinese-zodiac \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2024}'
{
  "year": 2024
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.chinese_zodiac",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

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

1リクエストあたり$0.002

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

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

教育、商品コピー、パーティーの豆知識にはブラウザで無料にご利用いただき、CI、ローカライゼーションテーブル、文化的なカレンダー機能で再現可能な干支フィクスチャが必要な場合は、成功したリクエストごとに$0.002のAPIをご利用ください。

中国式干支の動物の意味とレスポンスの内容

この計算ツールは、1から9999までの必須の整数yearと、任意の西暦monthおよびdayフィールドを受け付けます。正規化されたyear、動物名、子から亥までの固定順序でのゼロ始まりのanimal_index、1始まりのcycle_position、(日付が旧正月より前の場合はyear-1になり得る)解決済みのzodiac_year、before_new_yearフラグ、chinese_zodiacというメソッドタグ、短い式の説明を返します。日付が指定された場合は、month、day、YYYY-MM-DD形式のdate文字列、その市民暦年に対して計算されたchinese_new_year関連のフィールドも併せて返します。入力が検証を通れば動物は完全に決定され、そうでなければinvalid_inputでリクエストは失敗します。拒否されるケースには、yearの欠落、非整数のyearトークン、文書化された範囲外の年、dayを伴わないmonthやその逆、4月31日のような存在しないカレンダー日が含まれます。

year・month・dayの読み取り方法とカットオフを再現可能に保つ仕組み

優先されるフィールドはyearですが、y、大文字のY、yrといった別名も受け付けるため、スプレッドシート、クエリ文字列、型付きフォームは列名を変えずに同じ契約を再利用できます。yearのみが指定された場合、zodiac_yearはyearに等しく、動物はインデックス=(年-4)を12で割った余り(子がゼロ)に従います。入力日付が旧正月より厳密に前であればbefore_new_yearはtrueとなり、zodiac_yearはyear-1になります。自動化されたパイプライン内で太陰太陽暦のカットオフを自前で再実装することなく同一の動物が必要な場合は、このページの無料ブラウザ実行と有料APIを組み合わせてご利用ください。

中国式干支のルックアップが文化・製品・ソフトウェアで役立つ場面

API経由では成功した検索1件につき$0.002がかかり、検証に失敗したリクエストは課金されず、レスポンスが返された後は何も保存されません。この無料のインタラクティブな探索と、同一結果を返す有料APIという分割は、KITのtier-Aカタログの他のツールと同様であり、単発の豆知識チェックから複数年にわたる文化カレンダーへ、数学的な結果を変えることなく移行できます。

決定的な文化フィクスチャ

ユニットテスト、ローカライゼーションパック、CIアサーション向けに再現可能なanimalとchinese_new_yearのフィールドを生成できます。

中国式干支計算ツールの料金はいくらですか?

このページのブラウザ版は無料です。API経由では成功したリクエストごとに$0.002がかかり、無効な入力には課金されません。

yearが整数でない場合はどうなりますか?

入力はinvalid_inputで拒否されます。yearは1から9999までの整数でなければなりません。

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