Čínský zvěrokruh a kalendář

Zvíře roku je nejznámější část tradice a nejčastěji se počítá špatně. Rok v BaZi nezačíná 1. ledna ani čínským Novým rokem, ale 立春 Lichun, okamžikem, kdy viditelná délka Slunce dosáhne 315°. V roce 2026 je to 2026-02-03T20:02:08Z, tedy 4. února v 04:02 pekingského času. Narozený 2. února patří k předchozímu zvířeti, i když kalendář na zdi už ukazuje nový rok.

Endpointy

Endpoint	Kredity	Co vrací
POST /v1/chinese/zodiac/animal	10	Zvíře roku, sloupec, elementy větve a kmene
POST /v1/chinese/zodiac/element	10	Fixní element větve a cyklický element kmene
POST /v1/chinese/zodiac/inner-animal	10	Vnitřní zvíře: větev měsíce
POST /v1/chinese/zodiac/secret-animal	10	Tajné zvíře: větev hodiny
POST /v1/chinese/zodiac/compatibility	10	Kompatibilita dvou zvířat podle 三合 a 六冲
POST /v1/chinese/lunar-date	10	Měsíční datum, přestupný měsíc, čínský Nový rok
POST /v1/chinese/solar-terms	10	Všechny 24 sluneční termíny roku s přesností na sekundu

Tři zvířata, ne jedno

Horoskopy v časopisech znají jedno zvíře. Tradice zná tři a odpovídají na různé otázky.

Zvíře	Odkud	Co znamená
Vnější	větev roku	Jak tě vidí ostatní
Vnitřní	větev měsíce	Motivy, soukromé “já”
Tajná	větev hodiny	Nejhlubší vrstva, často skrytá před samotným člověkem

Vnitřní zvíře je omezeno přesnými okamžiky 節, ne středem měsíce, takže narození 5. května a 6. května může dát různá zvířata.

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

Dvě elementy roku

Narozený v roce 1990 je “kovový kůň”, a v tomto jménu jsou dva různé elementy, které se snadno zaměňují.

• Cyklická pochází z nebeského kmene a mění se každé dva roky: 庚 je kov.
• Fixní patří zemské větvi navždy: 午 je oheň, a kůň je vždy ohnivý.

/chinese/zodiac/element vrací oba jako samostatná pole, fixedElement a cyclingElement, místo aby si je klient vybíral.

Kompatibilita

Hodnocení je postaveno na 三合 (tři harmonie) a 六冲 (šest střetů), tedy na geometrii kruhu větví, ne na seznamu názorů.

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

Kompatibilita zvířat je jedna vrstva, ne mapa

Porovnání zvířat roku je nejhrubší řez: zná o člověku právě jeden hieroglyf z osmi. Pro skutečné čtení vezmi /v1/bazi/chart obou a podívej se na interakce všech čtyř sloupců.

Měsíční datum

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

Měsíc začíná pekingským dnem, který obsahuje mladik. Přestupný měsíc opakuje číslo předchozího a neobsahuje 中氣: to je důvod jeho existence, ne vedlejší efekt.

Do roku 1929

Kalendář do roku 1929 se počítá podle pekingského místního středního času (UTC+7:45:40), a to je historický základ, ne naše konvence. Mladik, který připadá na minuty u místní polokoule, může posunout měsíc o den dál od tištěného almanachu té doby, protože se počítaly s přesností na den.

Dvacet čtyři sluneční termíny

Termín není datum z tabulky, ale okamžik, kdy se viditelná délka Slunce stane násobkem 15°. Bereme ho z efemerid, takže odpověď je stejná pro jakýkoli rok v rámci domény a nezávisí na tom, jestli někdo aktualizoval tabulku.

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

Pole terms obsahuje všech dvacet čtyři; zde je zobrazen první:

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

Dvanáct z dvaceti čtyř má opensPillarMonth: true: to jsou 節, které otevírají měsíc sloupců. Zbývajících dvanáct jsou 中氣, dělí měsíc na polovinu a určují, který měsíc bude přestupný.

Termín je okamžik, ne den, a den se liší

Čti utc, ne beijing, pokud tvůj uživatel není v Číně. Čína a Hongkong počítají podle UTC+8, Japonsko a Korea podle UTC+9, Vietnam podle UTC+7, takže jedna hodina ze dvaceti čtyř je okno, ve kterém národní almanachy tisknou různé kalendářní dny. Průměrně je to jeden termín za rok. V roce 2026 jsou dva: 雨水 je 18. února v Pekingu a 19. února v Tokiu, 芒種 je 5. a 6. června. Naše okamžiky reprodukují obě publikace s přesností na minutu.

Jazyky

Zvířata a elementy jsou přeloženy do 21 jazyků. Přidej ?lang= nebo "language" do těla, a vedle anglického tokenu se objeví pole *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" } }

Anglická pole zůstávají navždy na místě: lokalizace přidává, ne nahrazuje.