Tong Shu (scelta della data)

Tong Shu (通書) è l’almanacco cinese con cui tradizionalmente si sceglie il giorno. Due dei suoi livelli si calcolano in modo esatto, e sono proprio quelli implementati qui: i dodici ufficiali del giorno (建除十二神) e le ventotto dimore lunari (二十八宿).

Endpoint

Endpoint	Crediti	Cosa restituisce
POST /v1/chinese/tong-shu	10	Un giorno: pilastro del giorno, ufficiale, dimora, animale in scontro
POST /v1/chinese/tong-shu/select	20	I giorni di un intervallo che il registro approva per una singola attività

Dodici ufficiali del giorno

La regola è una sola. Il giorno il cui ramo terrestre coincide con il ramo del mese è 建 Establish, e da lì i dodici proseguono in cerchio. Il mese qui è determinato dal momento esatto del termine solare, non dal primo del mese, quindi l’ufficiale può cambiare a metà del mese di calendario.

#	中文	Nome	Di cosa parla il giorno
1	建	Establish	Iniziare, ma non concludere
2	除	Remove	Pulire, liberarsi di qualcosa
3	滿	Full	Pienezza, firme, inaugurazioni
4	平	Balance	Giorno piano, ordinario, sicuro
5	定	Stable	Ciò che deve durare
6	執	Control	Prendere in mano
7	破	Destruction	Il giorno che si scontra con il mese
8	危	Danger	Altezze e rischio
9	成	Success	Il più favorevole dei dodici
10	收	Collect	Raccogliere, ricevere
11	開	Open	Aprire, lasciar entrare
12	閉	Close	Sigillare; il più basso di tutti

Ventotto dimore lunari

La dimora cambia ogni giorno lungo un ciclo continuo di 28 giorni, e questo ciclo è agganciato alla settimana: 角 cade sempre di giovedì, perché 28 sono esattamente quattro settimane. Questa proprietà non è decorativa, è essa stessa una verifica: un’ancora sbagliata sposterebbe la sequenza rispetto all’almanacco pubblicato oppure romperebbe il giorno della settimana.

Esempio

Un giorno

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

Scelta della data

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

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

Nota

Tre verdetti, e neutral non significa “indifferente”. suitable e unsuitable sono ciò che il registro dice esplicitamente. neutral significa che la tradizione tace su quell’attività. Per questo i giorni “muti” per default non entrano nella selezione, e puoi richiederli con includeNeutral.

Attenzione

L’intervallo è limitato a 366 giorni, e uno più lungo viene rifiutato, non troncato. Una risposta accorciata in silenzio si leggerebbe come “dopo marzo non ci sono giorni buoni”, quando in realtà nessuno ha guardato lì. La risposta contiene sempre scanned, matched e dropped con il dettaglio, quindi la somma torna.

Cosa è verificato

• Gli ufficiali sono confrontati con un esempio svolto pubblicato: dicembre 2020 nel mese del Topo, dove l’11 dicembre è il primo Establish e l’8, il 9 e il 10 dicembre sono Collect, Open e Close. Tutti e quattro coincidono.
• Le dimore sono confrontate con la sequenza giornaliera di un almanacco giapponese di agosto 2026: venti giorni consecutivi, da 女 il primo agosto a 角 il venti. In più l’invariante del giorno della settimana, verificato su un secolo di date.
• Il pilastro del giorno ora è fissato da tre date pubblicate (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Prima erano citate solo in un commento e non venivano verificate da nulla.

La selezione si basa sugli ufficiali, non sulle dimore. La dimora viene restituita per ogni giorno, ma non filtra: il suo registro degli eventi varia da un almanacco all’altro, e non lo inventiamo. Per lo stesso motivo non sono implementate le tabelle 神煞: sono decine di serie sovrapposte, senza accordo tra le fonti.