Zodiaque chinois et calendrier

L’animal de l’année est la partie la plus connue de la tradition et la plus souvent mal calculée. L’année en BaZi ne commence pas le 1er janvier ni avec le Nouvel An chinois, mais avec 立春 Lichun, le moment où la longitude apparente du Soleil atteint 315°. En 2026, cela correspond à 2026-02-03T20:02:08Z, soit le 4 février à 04:02 heure de Pékin. Quelqu’un né le 2 février appartient à l’animal précédent, même si le calendrier mural indique déjà la nouvelle année.

Endpoints

| Endpoint | Credits | Ce qui est retourné | |---|:|---| | POST /v1/chinese/zodiac/animal | 10 | Animal de l’année, pilier, éléments de la branche et du tronc | | POST /v1/chinese/zodiac/element | 10 | Élément fixe de la branche et élément cyclique du tronc | | POST /v1/chinese/zodiac/inner-animal | 10 | Animal intérieur : branche du mois | | POST /v1/chinese/zodiac/secret-animal | 10 | Animal secret : branche de l’heure | | POST /v1/chinese/zodiac/compatibility | 10 | Compatibilité des deux animaux selon les 三合 et les 六冲 | | POST /v1/chinese/lunar-date | 10 | Date lunaire, mois intercalaire, Nouvel An chinois | | POST /v1/chinese/solar-terms | 10 | Tous les 24 termes de l’année avec précision à la seconde |

Trois animaux, et non un seul

Les horoscopes des magazines connaissent un seul animal. La tradition en connaît trois, et ils répondent à différentes questions.

| Animal | Origine | Signifie | |---|:|---| | Extérieure | branche de l’année | Ce que les autres voient chez la personne | | Intérieure | branche du mois | Motifs, moi intérieur “je” | | Secrète | branche de l’heure | Couche la plus profonde, souvent cachée même à la personne |

L’animal intérieur est limité par les périodes précises 節, et non par le milieu du mois, donc une naissance le 5 mai ou le 6 mai peut donner des animaux différents.

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

Deux éléments de l’année

Quelqu’un né en 1990 est un “cheval de métal”, et dans ce nom il y a deux éléments différents qui sont facilement confondus.

• Cyclique vient du tronc céleste et change tous les deux ans: 庚 est le métal.
• Fixe appartient à la branche terrestre pour toujours: 午 est le feu, et le cheval est toujours de feu.

/chinese/zodiac/element renvoie les deux séparément sous les champs fixedElement et cyclingElement, au lieu de choisir pour le client.

Compatibilité

L’évaluation se base sur les 三合 (trois harmonies) et les 六冲 (six conflits), c’est-à-dire sur la géométrie du cercle des branches, et non sur une liste d’opinions.

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 comparaison des animaux de l’année est la coupe la plus grossière : elle ne connaît qu’un seul hiéroglyphe sur huit concernant la personne. Pour une lecture réelle, prenez /v1/bazi/chart des deux et observez les interactions de tous les quatre piliers.

Date lunaire

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

Le mois commence avec le jour de Pékin qui contient la nouvelle lune. Le mois intercalaire répète le numéro du mois précédent et ne contient pas le 中氣 : c’est la raison de son existence, et non un effet secondaire.

До 1929 року

Le calendrier avant 1929 était calculé selon le temps moyen local de Pékin (UTC+7:45:40), et c’est une base historique, et non notre convention. La nouvelle lune qui tombe à quelques minutes près de minuit local peut placer le mois à un jour de plus ou de moins par rapport à l’almanach imprimé de cette époque, car ceux-ci étaient calculés avec une précision d’un jour.

Vingt-quatre termes solaires

Un terme n’est pas une date provenant d’un tableau, mais l’instant où la longitude apparente du Soleil devient un multiple de 15°. Nous le prenons auprès des éphémérides, donc la réponse est la même pour n’importe quelle année dans le domaine et ne dépend pas du fait que quelqu’un ait mis à jour le tableau.

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

Le tableau terms contient tous les vingt-quatre ; voici le premier :

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

Douze sur vingt-quatre portent opensPillarMonth: true : ce sont les 節 qui ouvrent le mois du pilier. Les douze autres sont les 中氣, ils divisent le mois en deux et déterminent quel mois sera intercalaire.

Термін це мить, а не день, і день у нього різний

Lisez utc, et non beijing, si votre utilisateur n’est pas en Chine. La Chine et Hong Kong utilisent UTC+8, le Japon et la Corée UTC+9, le Viêt Nam UTC+7, donc une heure parmi les vingt-quatre est une fenêtre où les almanachs nationaux impriment différents jours calendaires. En moyenne, c’est un terme par an. En 2026, il y en a deux : 雨水 le 18 février à Pékin et le 19 février à Tokyo, 芒種 le 5 et 6 juin. Nos instants reproduisent les deux publications avec une précision à la minute.

Langues

Les animaux et les éléments sont traduits en 21 langues. Ajoutez ?lang= ou "language" dans le corps, et à côté du jeton anglais apparaîtra un champ *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" } }

Les champs anglais restent en place définitivement : la localisation ajoute, ne remplace pas.