Zodiaco cinese e calendario

L’animale dell’anno è la parte più famosa della tradizione e spesso calcolata in modo errato. L’anno in BaZi non inizia il 1° gennaio né con il Capodanno cinese, ma con 立春 Lichun, il momento in cui la longitudine apparente del Sole raggiunge 315°. Nel 2026 è 2026-02-03T20:02:08Z, cioè il 4 febbraio alle 04:02 ora di Pechino. Chi nasce il 2 febbraio appartiene all’animale precedente, anche se il calendario sul muro mostra già il nuovo anno.

Endpoint

Endpoint	Crediti	Cosa restituisce
POST /v1/chinese/zodiac/animal	10	Animale dell’anno, pilastro, elementi del ramo e del tronco
POST /v1/chinese/zodiac/element	10	Elemento fisso del ramo e elemento ciclico del tronco
POST /v1/chinese/zodiac/inner-animal	10	Animale interno: ramo del mese
POST /v1/chinese/zodiac/secret-animal	10	Animale segreto: ramo dell’ora
POST /v1/chinese/zodiac/compatibility	10	Compatibilità di due animali secondo 三合 e 六冲
POST /v1/chinese/lunar-date	10	Data lunare, mese intercalare, Capodanno cinese
POST /v1/chinese/solar-terms	10	Tutti i 24 termini dell’anno con precisione al secondo

Tre animali, non uno

Gli oroscopi nelle riviste conoscono un solo animale. La tradizione ne conosce tre, e rispondono a domande diverse.

Animale	Da dove	Cosa significa
Esterno	ramo dell’anno	Come gli altri vedono la persona
Interno	ramo del mese	Motivazioni, “io” privato
Segreto	ramo dell’ora	Lo strato più profondo, spesso nascosto alla stessa persona

L’animale interno è limitato ai momenti precisi 節, non alla metà del mese, quindi una nascita il 5 maggio o il 6 maggio può dare animali diversi.

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

Due elementi dell’anno

Chi è nato nel 1990 è un “cavallo di metallo”, e in questo nome ci sono due elementi diversi, facili da confondere.

• Ciclico proviene dal tronco celeste e cambia ogni due anni: 庚 è metallo.
• Fisso appartiene al ramo terrestre per sempre: 午 è fuoco, e il cavallo è sempre di fuoco.

/chinese/zodiac/element restituisce entrambi come campi separati, fixedElement e cyclingElement, invece di far scegliere il client.

Compatibilità

La valutazione si basa su 三合 (tre armonie) e 六冲 (sei scontri), cioè sulla geometria del cerchio dei rami, non su una lista di opinioni.

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

La compatibilità degli animali è un solo strato, non una mappa

Il confronto degli animali dell’anno è il taglio più grezzo: conosce la persona con un solo geroglifico su otto. Per una lettura reale prendi /v1/bazi/chart di entrambi e guarda le interazioni di tutti e quattro i pilastri.

Data lunare

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

Il mese inizia dal giorno di Pechino che contiene il giovane. Il mese intercalare ripete il numero del precedente e non contiene 中氣: è la ragione della sua esistenza, non un effetto collaterale.

Fino al 1929

Il calendario fino al 1929 è calcolato con il tempo medio locale di Pechino (UTC+7:45:40), ed è una base storica, non una nostra convenzione. Il giovane, che cade nei minuti vicino al nord locale, può spostare il mese di un giorno rispetto all’almanacco stampato di quel giorno, perché quelli erano calcolati con precisione al giorno.

Ventiquattro termini solari

Il termine non è una data della tabella, ma il momento in cui la longitudine apparente del Sole diventa multipla di 15°. Lo prendiamo dalle effemeridi, quindi la risposta è la stessa per qualsiasi anno nel dominio e non dipende dal fatto che qualcuno abbia aggiornato la tabella.

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

L’array terms contiene tutti i ventiquattro; qui è mostrato il primo:

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

Dodici dei ventiquattro hanno opensPillarMonth: true: sono 節, che aprono il mese dei pilastri. Gli altri dodici sono 中氣, dividono il mese a metà e determinano quale mese sarà intercalare.

Il termine è un momento, non un giorno, e il giorno è diverso

Leggi utc e non beijing se il tuo utente non è in Cina. Cina e Hong Kong usano UTC+8, Giappone e Corea UTC+9, Vietnam UTC+7, quindi un’ora dei ventiquattro è una finestra in cui gli almanacchi nazionali stampano giorni di calendario diversi. In media è un termine all’anno. Nel 2026 ce ne sono due: 雨水 è il 18 febbraio a Pechino e il 19 febbraio a Tokyo, 芒種 è il 5 e il 6 giugno. I nostri momenti riproducono entrambe le pubblicazioni con precisione al minuto.

Lingue

Animali e elementi sono tradotti in 21 lingue. Aggiungi ?lang= o "language" nel corpo, e accanto al token inglese apparirà il campo *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" } }

I campi inglesi rimangono al loro posto per sempre: la localizzazione aggiunge, non sostituisce.