Zodiacul chinezesc și calendarul

Animalul anului este cea mai cunoscută parte a tradiției și este cel mai adesea calculată greșit. Anul în BaZi nu începe pe 1 ianuarie și nici cu Anul Nou chinezesc, ci cu 立春 Lichun, momentul când longitudinea vizibilă a Soarelui ajunge la 315°. În 2026 este 2026-02-03T20:02:08Z, adică 4 februarie la 04:02 ora Beijingului. Cine s-a născut pe 2 februarie aparține animalului anterior, deși calendarul de pe perete arată deja anul nou.

Endpointuri

Endpoint	Credite	Ce returnează
POST /v1/chinese/zodiac/animal	10	Animalul anului, stâlp, elementele ramurii și ale trunchiului
POST /v1/chinese/zodiac/element	10	Element fix al ramurii și element ciclic al trunchiului
POST /v1/chinese/zodiac/inner-animal	10	Animalul interior: ramura lunii
POST /v1/chinese/zodiac/secret-animal	10	Animalul secret: ramura orei
POST /v1/chinese/zodiac/compatibility	10	Compatibilitatea a două animale conform 三合 și 六冲
POST /v1/chinese/lunar-date	10	Data lunară, lună bisectă, Anul Nou chinezesc
POST /v1/chinese/solar-terms	10	Toate cele 24 de termeni ai anului cu precizie la secundă

Trei animale, nu una

Horoscoapele din reviste cunosc un singur animal. Tradiția cunoaște trei, și ele răspund la întrebări diferite.

Animal	De unde	Ce înseamnă
Exterioară	ramura anului	Cum te vede ceilalți
Interioară	ramura lunii	Motive, “eu” privat
Secretă	ramura orei	Cel mai profund strat, adesea ascuns de însăși persoana

Animalul interior este limitat la momentele precise 節, nu la mijlocul lunii, așa că nașterea pe 5 mai și 6 mai poate da animale diferite.

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

Două elemente ale anului

Cine s-a născut în 1990 este un “cal metalic”, și în acest nume există două elemente diferite, ușor de confundat.

• Ciclică provine din tulpina cerească și se schimbă la fiecare doi ani: 庚 este metal.
• Fixă aparține ramurii pământene pentru totdeauna: 午 este foc, și calul este mereu focos.

/chinese/zodiac/element returnează ambele ca câmpuri separate, fixedElement și cyclingElement, în loc să aleagă pentru client.

Compatibilitate

Evaluarea se bazează pe 三合 (trei armonii) și 六冲 (șase coliziuni), adică pe geometria cercului ramurilor, nu pe o listă de 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."]
  }
}

Compatibilitatea animalelor este un singur strat, nu o hartă

Compararea animalelor anului este cea mai brută secțiune: știe despre persoană exact un singur hieroglif din opt. Pentru o lectură reală, ia /v1/bazi/chart pentru amândoi și privește interacțiunile tuturor celor patru stâlpi.

Data lunară

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

Luna începe cu ziua din Beijing care conține “młodzik”. Luna bisectă repetă numărul lunii precedente și nu conține 中氣: aceasta este motivul existenței sale, nu un efect secundar.

Până în 1929

Calendarul până în 1929 este calculat în timpul mediu local al Beijingului (UTC+7:45:40), și aceasta este o bază istorică, nu convenția noastră. “Młodzik” care cade în minutele apropiate de miezul nopții locale poate muta luna cu o zi în față față de almanahul tipărit al acelei zile, deoarece acestea erau calculate cu precizie la zi.

Douăzeci și patru de termeni solari

Un termen nu este o dată din tabel, ci momentul când longitudinea vizibilă a Soarelui devine multiplu de 15°. O luăm din efemeride, așa că răspunsul este același pentru orice an în domeniu și nu depinde dacă cineva a actualizat tabelul.

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

Array-ul terms conține toate cele douăzeci și patru; aici este afișat primul:

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

Douăsprezece din cele douăzeci și patru au opensPillarMonth: true: acestea sunt 節, care deschid luna stâlpilor. Restul de douăsprezece sunt 中氣, ele împarte luna în jumătate și determină care lună va fi bisectă.

Termenul este un moment, nu o zi, și ziua lui variază

Citește utc, nu beijing, dacă utilizatorul tău nu este în China. China și Hong Kong calculează în UTC+8, Japonia și Coreea în UTC+9, Vietnam în UTC+7, așa că o oră din cele douăzeci și patru este o fereastră în care almanahurile naționale tipăresc zile calendaristice diferite. În medie este un termen pe an. În 2026 sunt două: 雨水 este 18 februarie la Beijing și 19 februarie la Tokyo, 芒種 este 5 și 6 iunie. Momentele noastre reproduc ambele publicații cu precizie la minut.

Limbi

Animalele și elementele sunt traduse în 21 de limbi. Adaugă ?lang= sau "language" în corp, și lângă tokenul englez va apărea câmpul *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" } }

Câmpurile în engleză rămân pe loc pentru totdeauna: localizarea adaugă, nu înlocuiește.