Tong Shu (alegerea datei)

Tong Shu (通書) este almanahul chinezesc după care se alege în mod tradițional o zi. Două dintre straturile lui se calculează exact, și tocmai acestea sunt implementate aici: cei doisprezece ofițeri ai zilei (建除十二神) și cele douăzeci și opt de conace lunare (二十八宿).

Endpoint-uri

Endpoint	Credite	Ce returnează
POST /v1/chinese/tong-shu	10	O singură zi: pilonul zilei, ofițerul, conacul, animalul de conflict
POST /v1/chinese/tong-shu/select	20	Zilele dintr-un interval pe care registrul le aprobă pentru o acțiune

Cei doisprezece ofițeri ai zilei

Regula este una singură. Ziua a cărei ramură terestră coincide cu ramura lunii este 建 Establish, iar de acolo cei doisprezece urmează în cerc. Luna este definită aici de momentul exact al termenului solar, nu de prima zi a lunii, de aceea ofițerul se poate schimba la mijlocul unei luni calendaristice.

#	中文	Nume	Despre ce este ziua
1	建	Establish	Început, dar nu încheiere
2	除	Remove	A curăța, a scăpa de ceva
3	滿	Full	Plenitudine, semnări, deschideri
4	平	Balance	Zi egală, obișnuită, sigură
5	定	Stable	Ce trebuie să dureze
6	執	Control	A lua în mâini
7	破	Destruction	Ziua care se ciocnește cu luna
8	危	Danger	Înălțime și risc
9	成	Success	Cea mai favorabilă dintre cele douăsprezece
10	收	Collect	A aduna, a primi
11	開	Open	A deschide, a lăsa să intre
12	閉	Close	A sigila; acestea sunt cele mai de jos

Cele douăzeci și opt de conace lunare

Conacul se schimbă în fiecare zi, într-un ciclu continuu de 28 de zile, iar acest ciclu este legat de săptămână: 角 cade mereu joia, pentru că 28 înseamnă exact patru săptămâni. Proprietatea aceasta nu este decorativă, ea este chiar verificarea: o ancoră greșită fie ar deplasa secvența față de almanahul publicat, fie ar strica ziua săptămânii.

Exemplu

O singură zi

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

Alegerea datei

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

Acțiuni: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Mențiune

Trei verdicte, iar neutral nu înseamnă “indiferent”. suitable și unsuitable sunt ceea ce registrul spune explicit. neutral înseamnă că tradiția tace despre acțiunea respectivă. De aceea zilele tăcute nu intră implicit în selecție, dar le poți cere prin includeNeutral.

Atenție

Intervalul este limitat la 366 de zile, iar unul mai lung este respins, nu trunchiat. Un răspuns scurtat pe tăcute ar fi citit ca “după martie nu există zile bune”, deși de fapt nimeni nu s-a uitat acolo. Răspunsul conține mereu scanned, matched și dropped cu defalcarea lor, astfel încât suma să se potrivească.

Ce a fost verificat

• Ofițerii au fost comparați cu un exemplu rezolvat publicat: decembrie 2020, în luna Șobolanului, unde 11 decembrie este primul Establish, iar 8, 9 și 10 decembrie sunt Collect, Open și Close. Toate patru coincid.
• Conacele au fost comparate cu secvența zilnică a unui almanah japonez pentru august 2026: douăzeci de zile la rând, de la 女 pe 1 august până la 角 pe 20. În plus, invariantul zilei săptămânii, verificat pe un secol de date.
• Pilonul zilei este acum fixat prin trei date publicate (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Înainte erau doar menționate într-un comentariu și nimic nu le verifica.

Selecția se face după ofițeri, nu după conace. Conacul este returnat pentru fiecare zi, dar nu filtrează: registrul lui de evenimente diferă de la un almanah la altul, iar noi nu îl inventăm. Din același motiv, tabelele 神煞 nu sunt implementate: sunt zeci de serii care se suprapun, fără acord între surse.