中国の十二支とカレンダー

動物の年は伝統の中で最もよく知られている部分ですが、最も頻繁に間違って計算されています。BaZiでの年は1月1日や中国の旧正月ではなく、立春 Lichunから始まります。これは太陽の視黄経が315°に達する瞬間です。2026年ではこれは2026-02-03T20:02:08Zであり、北京時間で2月4日04:02を意味します。2月2日生まれの人は前の動物に属しますが、壁のカレンダーはすでに新年を示しています。

エンドポイント

エンドポイント	クレジット	戻り値
POST /v1/chinese/zodiac/animal	10	年の動物、柱、枝と幹の五行
POST /v1/chinese/zodiac/element	10	枝の固定五行と幹の循環五行
POST /v1/chinese/zodiac/inner-animal	10	内在動物：月の枝
POST /v1/chinese/zodiac/secret-animal	10	秘密動物：時の枝
POST /v1/chinese/zodiac/compatibility	10	三合と六冲による二つの動物の相性
POST /v1/chinese/lunar-date	10	月の日、閏月、中国の旧正月
POST /v1/chinese/solar-terms	10	秒単位の精度での年の24の節気

三つの動物、一つではない

雑誌の占いは一つの動物を知っています。伝統は三つを知っており、それらは異なる質問に答えます。

動物	どこから	何を意味するか
外側	年の枝	他人がどのように人を見るか
内側	月の枝	動機、私的な「自分」
秘密	時の枝	最も深い層、しばしば本人からも隠されている

内在動物は月の真ん中ではなく、正確な節気の瞬間によって制限されるため、5月5日と6月6日の生まれは異なる動物を与えることがあります。

curl -X POST https://api.astroway.info/v1/chinese/zodiac/inner-animal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

{
  "ok": true,
  "data": {
    "innerAnimal": "Snake",
    "glyph": "🐍",
    "description": "Inner animal = the BaZi month branch, bounded by the exact 節 instants. Represents internal motivations and the private self."
  }
}

年の二つの五行

1990年生まれの人は「金属の馬」ですが、この名前には混同しやすい二つの異なる五行があります。

• 循環五行は天干から来て、二年ごとに変わります：庚は金属です。
• 固定五行は地支に永遠に属します：午は火であり、馬は常に火のものです。

/chinese/zodiac/elementは、クライアント側で選択するのではなく、両方を別々のフィールドfixedElementとcyclingElementとして返します。

相性

評価は三合（三つの調和）と六冲（六つの衝突）に基づいており、つまり枝の円の幾何学に基づいており、意見のリストではありません。

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-05-15"},"person2":{"date":"1988-02-20"}}'

{
  "person1": { "solarYear": 1990, "animal": "Horse" },
  "person2": { "solarYear": 1988, "animal": "Dragon" },
  "compatibility": {
    "score": 65,
    "category": "good",
    "notes": ["Compatible enough; complementary differences."]
  }
}

動物の相性は一つの層であり、チャートではありません

年の動物の比較は最も粗い切り取りです：それは人についてちょうど一つの漢字を知っています。本当の占いには、両方の/v1/bazi/chartを取得し、四つの柱の相互作用を見てください。

月の日付

curl -X POST https://api.astroway.info/v1/chinese/lunar-date \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-02-17"}'

{
  "gregorianDate": "2026-02-17",
  "lunar": { "month": 1, "isLeapMonth": false, "day": 1, "monthStart": "2026-02-17", "label": "month 1, day 1" },
  "chineseNewYear": "2026-02-17"
}

月は新月を含む北京の日から始まります。閏月は前の月の番号を繰り返し、中気を含みません：これがその存在の理由であり、副作用ではありません。

1929年以前

1929年以前のカレンダーは北京地方平均時（UTC+7:45:40）で計算されており、これは我々の便宜的なものではなく歴史的な基盤です。現地の真夜中に近い分に発生する新月は、印刷された暦のその日から月を一日遅らせる可能性があります。なぜなら、それらは日単位の精度で計算されていたからです。

二十四節気

節気は表からの日付ではなく、太陽の視黄経が15°の倍数になる瞬間です。私たちはそれを星暦から取得するため、応答はドメイン内のどの年でも同じであり、誰かが表を更新したかどうかに依存しません。

curl -X POST https://api.astroway.info/v1/chinese/solar-terms \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

terms配列はすべての二十四を持ちます；ここに最初のものを示します：

{
  "year": 2026,
  "terms": [
    {
      "index": 0,
      "chinese": "立春",
      "pinyin": "Lichun",
      "english": "Start of Spring",
      "sunLongitude": 315,
      "utc": "2026-02-03T20:02:08Z",
      "beijing": "2026-02-04T04:02:08+08:00",
      "opensPillarMonth": true
    }
  ]
}

二十四のうち十二はopensPillarMonth: trueを持ちます：これは月の柱を開く節気です。残りの十二は中気であり、月を半分に分割し、どの月が閏月になるかを決定します。

節気は瞬間であり、日ではなく、その日は異なります

ユーザーが中国にいない場合はutcを読み、beijingを読まないでください。中国と香港はUTC+8で、日本と韓国はUTC+9、ベトナムはUTC+7で計算するため、二十四時間のうちの一時間は、各国の暦が異なる暦の日を印刷するウィンドウです。平均してこれは年に一つの節気です。2026年には二つあります：雨水は北京では2月18日、東京では2月19日であり、芒種は5月6日と6月6日です。私たちの瞬間は両方の出版物を分単位の精度で再現します。

言語

動物と五行は21の言語に翻訳されています。?lang=または"language"を本文に追加すると、英語のトークンに*Nameフィールドが表示されます：

curl -X POST "https://api.astroway.info/v1/chinese/zodiac/animal?lang=es" \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15"}'

{ "animal": "Horse", "animalName": "Caballo", "element": { "fixed": "Fire", "fixedName": "Fuego" } }

英語のフィールドは永久にその場に留まります：ローカライズは追加するだけで、置き換えません。