Chiński zodiak i kalendarz

Zwierzę roku to najbardziej znana część tradycji i najczęściej liczone niepoprawnie. Rok w BaZi zaczyna się nie 1 stycznia i nie od chińskiego Nowego Roku, ale od 立春 Lichun, momentu, kiedy widzialna długość geograficzna Słońca dochodzi do 315°. W 2026 roku to 2026-02-03T20:02:08Z, czyli 4 lutego o 04:02 czasu pekińskiego. Osoba urodzona 2 lutego należy do poprzedniego zwierzęcia, choć kalendarz na ścianie już pokazuje nowy rok.

Endpointy

Endpoint	Kredyty	Co zwraca
POST /v1/chinese/zodiac/animal	10	Zwierzę roku, słup, żywioły gałęzi i pnia
POST /v1/chinese/zodiac/element	10	Stały żywioł gałęzi i cykliczny żywioł pnia
POST /v1/chinese/zodiac/inner-animal	10	Wewnętrzne zwierzę: gałąź miesiąca
POST /v1/chinese/zodiac/secret-animal	10	Tajne zwierzę: gałąź godziny
POST /v1/chinese/zodiac/compatibility	10	Kompatybilność dwóch zwierząt według 三合 i 六冲
POST /v1/chinese/lunar-date	10	Data księżycowa, miesiąc przestępny, chiński Nowy Rok
POST /v1/chinese/solar-terms	10	Wszystkie 24 terminy roku z dokładnością do sekundy

Trzy zwierzęta, a nie jedno

Horoskopy w czasopismach znają jedno zwierzę. Tradycja zna trzy i odpowiadają na różne pytania.

Zwierzę	Skąd	Co oznacza
Zewnętrzne	gałąź roku	To, jak człowieka widzą inni
Wewnętrzne	gałąź miesiąca	Motywy, prywatne “ja”
Tajne	gałąź godziny	Najgłębsza warstwa, często ukryta przed samą osobą

Wewnętrzne zwierzę jest ograniczone dokładnymi momentami 節, a nie środkiem miesiąca, dlatego urodzenie 5 maja i 6 maja może dawać różne zwierzęta.

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

Dwie żywioły roku

Urodzony w 1990 roku to “metalowy koń”, i w tej nazwie są dwa różne żywioły, które łatwo pomylić.

• Cykliczna pochodzi od niebiańskiego pnia i zmienia się co dwa lata: 庚 to metal.
• Stała należy do ziemskiej gałęzi na zawsze: 午 to ogień, i koń zawsze jest ognisty.

/chinese/zodiac/element zwraca oba jako osobne pola, fixedElement i cyclingElement, zamiast wybierać po stronie klienta.

Kompatybilność

Ocena opiera się na 三合 (trzy harmonie) i 六冲 (sześć zderzeń), czyli na geometrii koła gałęzi, a nie na liście opinii.

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

Kompatybilność zwierząt to jedna warstwa, a nie mapa

Porównanie zwierząt roku to najgrubszy przycięcie: zna o człowieku dokładnie jeden hieroglif z ośmiu. Do rzeczywistego odczytu weź /v1/bazi/chart obu i patrz na interakcje wszystkich czterech słupów.

Data księżycowa

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

Miesiąc zaczyna się od pekińskiego dnia, który zawiera młodzik. Miesiąc przestępny powtarza numer poprzedniego i nie zawiera 中氣: to powód jego istnienia, a nie efekt uboczny.

Do 1929 roku

Kalendarz do 1929 roku liczony jest według pekińskiego lokalnego średniego czasu (UTC+7:45:40), i to jest historyczna podstawa, a nie nasza konwencja. Młodzik, który przypada na minuty w pobliżu lokalnej północy, może przesunąć miesiąc o dzień dalej od drukowanego almanachu tego dnia, ponieważ były liczone z dokładnością do dnia.

Dwadzieścia cztery terminy słoneczne

Termin to nie data z tabeli, ale moment, kiedy widzialna długość geograficzna Słońca staje się wielokrotnością 15°. Pobieramy ją z efemeryd, więc odpowiedź jest taka sama dla każdego roku w zakresie domeny i nie zależy od tego, czy ktoś zaktualizował tabelę.

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

Tablica terms zawiera wszystkie dwadzieścia cztery; tutaj pokazany jest pierwszy:

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

Dwanaście z dwudziestu czterech ma opensPillarMonth: true: to są 節, które otwierają miesiąc słupów. Pozostałe dwanaście to 中氣, dzielą miesiąc na pół i określają, który miesiąc będzie przestępny.

Termin to moment, a nie dzień, i dzień w nim jest różny

Czytaj utc, a nie beijing, jeśli twój użytkownik nie jest w Chinach. Chiny i Hongkong liczą według UTC+8, Japonia i Korea według UTC+9, Wietnam według UTC+7, więc jedna godzina z dwudziestu czterech to okno, w którym narodowe almanachy drukują różne dni kalendarzowe. Średnio to jeden termin na rok. W 2026 są dwa: 雨水 to 18 lutego w Pekinie i 19 lutego w Tokio, 芒種 to 5 i 6 czerwca. Nasze momenty odtwarzają obie publikacje z dokładnością do minuty.

Języki

Zwierzęta i żywioły przetłumaczono na 21 języków. Dodaj ?lang= lub "language" w ciele, i obok angielskiego tokenu pojawi się 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" } }

Angielskie pola pozostają na miejscu na zawsze: lokalizacja dodaje, a nie zastępuje.