Kínai állatövi és naptár

Az év állata a hagyomány legismertebb, és leggyakrabban hibásan számított része. A BaZi év nem január 1-jén és nem a kínai újévvel kezdődik, hanem 立春 Lichun-nal, azzal a pillanattal, amikor a Nap látszólagos hossza eléri a 315°-ot. 2026-ban ez 2026-02-03T20:02:08Z, azaz február 4-én 04:02-kor pekingi idő szerint. A február 2-án született személy az előző állathoz tartozik, bár a fali naptár már az új évet mutatja.

Végpontok

Végpont	Kreditek	Amit visszaad
POST /v1/chinese/zodiac/animal	10	Az év állata, oszlop, az ág és a törzs elemei
POST /v1/chinese/zodiac/element	10	Az ág rögzített eleme és a törzs ciklikus eleme
POST /v1/chinese/zodiac/inner-animal	10	Belső állat: a hónap ága
POST /v1/chinese/zodiac/secret-animal	10	Titkos állat: az óra ága
POST /v1/chinese/zodiac/compatibility	10	Két állat kompatibilitása 三合 és 六冲 szerint
POST /v1/chinese/lunar-date	10	Holdnaptári dátum, szökőhónap, kínai újév
POST /v1/chinese/solar-terms	10	Az év mind a 24 terminusza másodperc pontossággal

Három állat, nem egy

A magazinok horoszkópjai egy állatot ismernek. A hagyomány hármat ismer, és ezek különböző kérdésekre adnak választ.

Állat	Honnan	Mit jelent
Külső	az év ága	Ahogyan mások látják az embert
Belső	a hónap ága	Motívumok, privát “én”
Titkos	az óra ága	A legmélyebb réteg, gyakran az ember elől is rejtve

A belső állat a pontos 節 pillanatokhoz kötődik, nem a hónap közepéhez, ezért május 5-én és május 6-án születettek különböző állatokat kaphatnak.

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."
  }
}

Az év két eleme

Az 1990-ben született személy “fém ló”, és ebben a névben két különböző elem található, amelyeket könnyű összetéveszteni.

• A ciklikus az égi törzsből származik, és kétévente változik: 庚 fém.
• A rögzített örökre a földi ághoz tartozik: 午 tűz, és a ló mindig tűz elemű.

A /chinese/zodiac/element mindkettőt külön mezőben adja vissza, fixedElement és cyclingElement, ahelyett, hogy a kliens helyett választana.

Kompatibilitás

Az értékelés a 三合 (három harmónia) és 六冲 (hat ütközés) alapján épül fel, azaz az ágak körének geometriáján, nem pedig vélemények listáján.

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."]
  }
}

Az állatok kompatibilitása egy réteg, nem egy térkép

Az év állatainak összehasonlítása a legdurvább metszet: pontosan egy hieroglifát ismer az emberről a nyolcból. A valós olvasáshoz vedd mindkét személy /v1/bazi/chart adatait, és nézd meg mind a négy oszlop kölcsönhatásait.

Holdnaptári dátum

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"
}

A hónap azzal a pekingi nappal kezdődik, amelyik tartalmazza az újholdat. A szökőhónap megismétli az előző hónap számát, és nem tartalmaz 中氣-t: ez a létezésének oka, nem pedig mellékhatása.

1929 előtt

Az 1929 előtti naptár a pekingi helyi közép idő (UTC+7:45:40) szerint számítódik, és ez történelmi alap, nem a mi konvenciónk. Az újhold, amely a helyi éjfél körüli percekre esik, egy nappal eltolhatja a hónapot az aznapi nyomtatott almanachhoz képest, mert azok napra pontosan számolódtak.

Huszonnégy szoláris terminus

A terminus nem egy táblázatból származó dátum, hanem az a pillanat, amikor a Nap látszólagos hossza 15°-nak többszöröse lesz. Ezt az efemeridákból vesszük, ezért a válasz bármely évre azonos a tartományon belül, és nem függ attól, hogy valaki frissítette-e a táblázatot.

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}'

A terms tömb mind a huszonnégyet tartalmazza; itt az első látható:

{
  "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
    }
  ]
}

A huszonnégyből tizenkettő opensPillarMonth: true értékkel rendelkezik: ezek a 節, amelyek megnyitják az oszlopok hónapját. A másik tizenkettő a 中氣, ezek kettéosztják a hónapot, és meghatározzák, melyik hónap lesz szökőhónap.

A terminus egy pillanat, nem egy nap, és a napja eltérő

Olvasd az utc értéket, ne a beijing értéket, ha a felhasználód nem Kínában van. Kína és Hongkong UTC+8 szerint számol, Japán és Korea UTC+9 szerint, Vietnam UTC+7 szerint, így a huszonnégy órából egy óra az az ablak, amelyben a nemzeti almanachok különböző naptári napokat nyomtatnak. Átlagosan ez évente egy terminus. 2026-ban kettő van belőlük: 雨水 február 18. Pekingben és február 19. Tokióban, 芒種 június 5. és 6. A mi pillanataink mindkét publikációt percre pontosan reprodukálják.

Nyelvek

Az állatok és elemek 21 nyelvre vannak lefordítva. Add hozzá a ?lang= vagy "language" paramétert a törzshöz, és az angol token mellett megjelenik egy *Name mező:

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" } }

Az angol mezők örökre a helyükön maradnak: a lokalizáció hozzáad, nem helyettesít.