Tong Shu (datumkeuze)

Tong Shu (通書) is de Chinese almanak waarmee traditioneel een dag wordt gekozen. Twee lagen ervan zijn exact te berekenen, en precies die zijn hier geïmplementeerd: de twaalf dagofficieren (建除十二神) en de achtentwintig maanhuizen (二十八宿).

Endpoints

Endpoint	Credits	Wat het teruggeeft
POST /v1/chinese/tong-shu	10	Eén dag: dagpilaar, officier, maanhuis, botsend dier
POST /v1/chinese/tong-shu/select	20	Dagen in een periode die het register goedkeurt voor één activiteit

De twaalf dagofficieren

Er is één regel. De dag waarvan de aardse tak samenvalt met de tak van de maand is 建 Establish, en daarna volgen de twaalf elkaar in een cirkel op. De maand wordt hier bepaald door het exacte moment van de zonneterm, niet door de eerste van de maand, dus de officier kan midden in een kalendermaand wisselen.

#	中文	Naam	Waar de dag voor staat
1	建	Establish	Beginnen, maar niet afronden
2	除	Remove	Opruimen, iets kwijtraken
3	滿	Full	Volheid, ondertekenen, openen
4	平	Balance	Gelijkmatig, alledaags, veilig
5	定	Stable	Wat moet blijven duren
6	執	Control	De zaken in handen nemen
7	破	Destruction	Een dag die botst met de maand
8	危	Danger	Hoogte en risico
9	成	Success	De gunstigste van de twaalf
10	收	Collect	Verzamelen, ontvangen
11	開	Open	Openen, binnenlaten
12	閉	Close	Verzegelen; de laagste

De achtentwintig maanhuizen

Het maanhuis wisselt elke dag in een doorlopende cyclus van 28 dagen, en die cyclus is gekoppeld aan de week: 角 valt altijd op een donderdag, omdat 28 precies vier weken is. Die eigenschap is niet decoratief, ze is juist de controle: een verkeerd ankerpunt zou de reeks ten opzichte van de gepubliceerde almanak verschuiven of de weekdag breken.

Voorbeeld

Eén dag

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

Datumkeuze

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

Activiteiten: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Opmerking

Drie oordelen, en neutral betekent niet “maakt niet uit”. suitable en unsuitable zijn wat het register expliciet zegt. neutral betekent dat de traditie over deze activiteit zwijgt. Daarom komen zwijgende dagen standaard niet in de selectie terecht; je kunt ze opvragen met includeNeutral.

Opgepast

De periode is beperkt tot 366 dagen, en een langere periode wordt geweigerd, niet ingekort. Een stilzwijgend ingekort antwoord zou gelezen worden als “na maart zijn er geen goede dagen”, terwijl daar in werkelijkheid niemand naar heeft gekeken. Het antwoord bevat altijd scanned, matched en dropped met een uitsplitsing, zodat de som klopt.

Wat er is gecontroleerd

• De officieren zijn vergeleken met een gepubliceerd uitgewerkt voorbeeld: december 2020 in de maand van de Rat, waarin 11 december de eerste Establish is en 8, 9 en 10 december Collect, Open en Close zijn. Alle vier kloppen.
• De maanhuizen zijn vergeleken met de dagreeks van een Japanse almanak voor augustus 2026: twintig dagen op rij, van 女 op 1 augustus tot 角 op 20 augustus. Daarnaast de weekdaginvariant, gecontroleerd over een eeuw aan datums.
• De dagpilaar is nu vastgepind op drie gepubliceerde datums (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Voorheen stonden die alleen in een commentaar en werden ze nergens gecontroleerd.

De selectie gaat op officieren, niet op maanhuizen. Het maanhuis wordt voor elke dag teruggegeven, maar filtert niet: het gebeurtenissenregister ervan verschilt tussen almanakken, en dat verzinnen we niet. Om dezelfde reden zijn de 神煞-tabellen niet geïmplementeerd: dat zijn tientallen overlappende reeksen zonder overeenstemming tussen de bronnen.