Tong Shu (choix de date)

Le Tong Shu (通書) est l’almanach chinois avec lequel on choisit traditionnellement un jour. Deux de ses couches se calculent exactement, et ce sont elles qui sont implémentées ici : les douze officiers du jour (建除十二神) et les vingt-huit demeures lunaires (二十八宿).

Endpoints

Endpoint	Crédits	Ce qu’il renvoie
POST /v1/chinese/tong-shu	10	Un jour : pilier du jour, officier, demeure, animal en conflit
POST /v1/chinese/tong-shu/select	20	Les jours d’une plage que le registre approuve pour une activité

Douze officiers du jour

Il n’y a qu’une règle. Le jour dont la branche terrestre coïncide avec celle du mois est 建 Establish, et les douze se succèdent ensuite en cercle. Le mois est ici déterminé par l’instant exact du terme solaire, pas par le premier du mois ; l’officier peut donc changer au milieu d’un mois civil.

#	中文	Nom	Ce que représente le jour
1	建	Establish	Un commencement, mais pas un achèvement
2	除	Remove	Faire le ménage, se débarrasser
3	滿	Full	Plénitude, signature, ouverture
4	平	Balance	Égal, ordinaire, sans risque
5	定	Stable	Ce qui doit durer
6	執	Control	Prendre en main
7	破	Destruction	Le jour qui s’oppose au mois
8	危	Danger	Hauteur et risque
9	成	Success	Le plus favorable des douze
10	收	Collect	Rassembler, recevoir
11	開	Open	Ouvrir, laisser entrer
12	閉	Close	Sceller ; le plus bas de tous

Vingt-huit demeures lunaires

La demeure change chaque jour sur un cercle continu de 28 jours, et ce cercle est lié à la semaine : 角 tombe toujours un jeudi, car 28 fait exactement quatre semaines. Cette propriété n’est pas décorative, c’est elle qui sert de vérification : une mauvaise ancre décalerait la séquence par rapport à l’almanach publié ou casserait le jour de la semaine.

Exemple

Un jour

curl -X POST https://api.astroway.info/v1/chinese/tong-shu \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "date": "2026-09-12" }'

Choix de date

curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-09-01", "to": "2026-12-31",
        "activity": "marriage", "avoidClashWith": "Rat" }'

Activités : marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Note

Trois verdicts, et neutral ne veut pas dire “peu importe”. suitable et unsuitable correspondent à ce que le registre dit explicitement. neutral signifie que la tradition ne dit rien de cette activité. C’est pourquoi les jours muets ne sont pas inclus dans la sélection par défaut ; tu peux les demander avec includeNeutral.

Attention

La plage est limitée à 366 jours, et une plage plus longue est rejetée, pas tronquée. Une réponse raccourcie en silence se lirait comme “aucun bon jour après mars”, alors qu’en réalité personne n’a regardé. La réponse contient toujours scanned, matched et dropped avec le détail, donc le total est cohérent.

Ce qui a été vérifié

• Les officiers sont confrontés à un exemple détaillé publié : décembre 2020, dans le mois du Rat, où le 11 décembre est le premier Establish, et les 8, 9 et 10 décembre sont Collect, Open et Close. Les quatre concordent.
• Les demeures sont confrontées à la séquence quotidienne d’un almanach japonais pour août 2026 : vingt jours d’affilée, de 女 le premier août à 角 le vingt. S’y ajoute l’invariant du jour de la semaine, vérifié sur un siècle de dates.
• Le pilier du jour est désormais fixé par trois dates publiées (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Auparavant, elles n’étaient citées que dans un commentaire et rien ne les vérifiait.

La sélection se fait par officiers, pas par demeures. La demeure est renvoyée pour chaque jour, mais ne filtre pas : son registre d’événements diffère d’un almanach à l’autre, et nous ne l’inventons pas. De même, les tables 神煞 ne sont pas implémentées : ce sont des dizaines de séries qui se chevauchent, sans accord entre les sources.