Métaphysique chinoise : questions fréquentes

Pourquoi ton calculateur donne-t-il d’autres piliers qu’un autre ?

Presque toujours, la cause est l’une de quatre, et aucune n’est une erreur. C’est un choix d’école que la plupart des calculateurs font en silence. Nos réponses et un passage sur un jeu de données externe sont sur la page des conventions.

Axe	Notre réponse
Limite de l’année	立春 Lichun, instant exact tiré des éphémérides
Limite du jour	23:00, le 子時 précoce appartient au jour suivant
Temps solaire vrai	désactivé par défaut, s’active par un flag
Heure d’été	résolue par le timezoneOffset que tu envoies

L’année commence-t-elle au Nouvel An chinois ou à Lichun ?

À Lichun, et ces deux dates s’écartent chaque année de deux à trois semaines. Le Nouvel An chinois marque le début de l’année lunaire et la fête ; les piliers reposent sur l’année solaire, qu’ouvre Lichun. Une personne née le 10 février 2026 appartient déjà au Cheval selon les piliers, alors que le Nouvel An tombait le 17 février.

/v1/chinese/lunar-date renvoie chineseNewYear dans un champ séparé précisément parce que c’est une autre grandeur, pas un synonyme.

Que faut-il envoyer si l’heure de naissance est inconnue ?

N’envoie pas du tout time. Trois piliers sur quatre seront calculés, et le pilier de l’heure n’apparaîtra tout simplement pas. C’est plus honnête que de mettre midi : une heure substituée produit un pilier de l’heure qui a l’air d’un fait sans en être un, et entraîne les 神煞 qui en dépendent.

Ce qui change sans l’heure :

• le pilier de l’heure est absent
• l’animal secret est absent
• l’équilibre des éléments est calculé sur six caractères au lieu de huit
• la force du Maître du jour se déplace, car un quart du thème disparaît

Quand activer trueSolarTime ?

Quand le lieu de naissance est loin du méridien de son fuseau horaire. La Chine, de Kachgar à Harbin, vit sur un seul UTC+8, et au Xinjiang l’écart atteint trois heures, soit une double heure et demie. Le flag décale le jour et l’heure, et volontairement pas l’année ni le mois : Lichun est un instant universel, et la lecture d’un cadran solaire n’a rien à voir avec lui.

curl -X POST https://api.astroway.info/v1/chinese/true-solar-time \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":8,"longitude":87.6}'

Pourquoi vos 藏干 sont-ils dans un autre ordre que dans le livre ?

L’ordre de notre liste suit les jours de 人元司令, c’est-à-dire l’ordre dans lequel les troncs cachés gouvernent le mois. Le rôle (principal, middle, residual) est un champ séparé et ne dépend pas de la position. Sur les quatre branches-réservoirs 丑辰未戌, le rôle médian appartient à l’élément que la branche conserve, et non au deuxième élément de la liste. C’est le point où les implémentations publiques divergent le plus souvent.

Calculez-vous le Zi Wei Dou Shu ?

Oui. POST /v1/ziwei/chart construit le thème en entier : les palais de la Vie et du Corps à partir du mois lunaire et de la double heure, 五行局 à partir du pilier du palais de la Vie, 紫微 selon la règle de division avec emprunt, les treize autres étoiles principales, six fastes et six néfastes, trente et une étoiles mineures, les douze stades, les cycles 博士, 將前 et 歲前, les périodes décennales et annuelle, avec les 四化 marqués directement sur les étoiles.

Onze routes /ziwei/* restent des tables de référence des palais et des étoiles. Elles portent le champ computed: false, coûtent la moitié du tarif et renvoient la même chose pour n’importe quelle date : c’est un dictionnaire, et c’est écrit comme tel. /ziwei/full-chart est déprécié jusqu’au 2027-11-26 au profit de /ziwei/chart.

Détails et vérification : Zi Wei Dou Shu.

En quoi êtes-vous meilleurs qu’une bibliothèque gratuite ?

En rien, si tu n’as besoin que des piliers. lunar-typescript, sous MIT, les calcule dans ton processus, hors ligne, sans limite de fréquence, et nous ne te conseillons pas de payer pour ce que tu peux ne pas acheter.

La différence commence au-delà : 神煞, les interactions des branches 刑冲合害, l’évaluation de la force du Maître du jour, le temps solaire vrai, les étoiles volantes selon l’assise et la façade, le nombre Kua, le choix de date Tong Shu. Et 21 langues pour tout cela. Plus ce pour quoi on paie vraiment d’habitude : une seule convention pour une équipe qui a du PHP sur le site, du JavaScript dans l’application et du Python dans les crons.

Pourquoi les animaux sont-ils nommés en anglais, et les troncs en pinyin ?

Les animaux et les éléments ont des noms établis dans chaque langue, donc ils sont traduits : 午 se dit Caballo en espagnol et ウマ en japonais. Les troncs, les branches, 納音 et les noms des étoiles n’ont pas de noms établis, et leur nom international est le pinyin à côté du caractère. Inventer un mot tchèque pour 甲 serait pire que de laisser 甲. La même règle s’applique dans le bloc Human Design.

Quelle plage de dates acceptez-vous ?

Les années 2 à 2899. Le calendrier est dérivé des éphémérides, il fonctionne donc bien au-delà des tables imprimées, mais pas sans limite : une sortie du domaine renvoie 400 avec le nom du champ, et non 500.

{ "ok": false, "error": { "code": "INVALID_INPUT",
  "message": "Validation failed: year: Too big: expected number to be <=2899" } }