Tong Shu (dátumválasztás)

A Tong Shu (通書) az a kínai almanach, amely alapján hagyományosan a napot választják. Két rétege pontosan kiszámítható, és itt éppen ezek vannak megvalósítva: a nap tizenkét felügyelője (建除十二神) és a huszonnyolc holdház (二十八宿).

Végpontok

Végpont	Kredit	Mit ad vissza
POST /v1/chinese/tong-shu	10	Egy nap: naposzlop, felügyelő, holdház, ütköző állat
POST /v1/chinese/tong-shu/select	20	A tartomány azon napjai, amelyeket a nyilvántartás egy adott tevékenységhez jóváhagy

A nap tizenkét felügyelője

A szabály egyetlen. Az a nap, amelynek földi ága megegyezik a hónap ágával, a 建 Establish, és innen a tizenkettő körben követi egymást. A hónapot itt a szoláris időszak pontos pillanata határozza meg, nem a hónap első napja, ezért a felügyelő a naptári hónap közepén is válthat.

#	中文	Név	Miről szól a nap
1	建	Establish	Kezdet, de nem befejezés
2	除	Remove	Eltakarítani, megszabadulni
3	滿	Full	Teljesség, aláírás, megnyitás
4	平	Balance	Kiegyensúlyozott, hétköznapi, biztonságos
5	定	Stable	Ami tartósnak szánt
6	執	Control	Kézbe venni
7	破	Destruction	A hónappal ütköző nap
8	危	Danger	Magasság és kockázat
9	成	Success	A tizenkettő közül a legkedvezőbb
10	收	Collect	Begyűjteni, megkapni
11	開	Open	Megnyitni, beengedni
12	閉	Close	Lezárni; ezek állnak a legalacsonyabban

A huszonnyolc holdház

A holdház naponta vált egy megszakítás nélküli, 28 napos körben, és ez a kör a héthez van kötve: a 角 mindig csütörtök, mert a 28 pontosan négy hét. Ez a tulajdonság nem díszítés, hanem maga az ellenőrzés: egy rossz horgony vagy elcsúsztatná a sorozatot a publikált almanachhoz képest, vagy elrontaná a hét napját.

Példa

Egy nap

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

Dátumválasztás

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

Tevékenységek: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Megjegyzés

Három ítélet, és a neutral nem azt jelenti, hogy “mindegy”. A suitable és az unsuitable az, amit a nyilvántartás kifejezetten kimond. A neutral azt jelenti, hogy a hagyomány erről a tevékenységről hallgat. Ezért a hallgatag napok alapértelmezés szerint nem kerülnek a találatok közé, de az includeNeutral segítségével kérheted őket.

Figyelem

A tartomány legfeljebb 366 nap, és a hosszabbat elutasítjuk, nem vágjuk le. Egy csendben megrövidített válasz úgy hatna, mintha “március után nincsenek jó napok”, holott valójában oda senki nem nézett. A válaszban mindig ott van a scanned, a matched és a dropped bontással, így az összeg stimmel.

Mi van ellenőrizve

• A felügyelőket egy publikált, kidolgozott példával vetettük össze: 2020 decembere a Patkány hónapjában, ahol december 11. az első Establish, december 8., 9. és 10. pedig Collect, Open és Close. Mind a négy egyezik.
• A holdházakat egy japán almanach 2026. augusztusi napi sorozatával vetettük össze: húsz egymást követő nap, augusztus elsejei 女-tól huszadiki 角-ig. Ehhez jön a hét napjának invariánsa, egy évszázadnyi dátumon ellenőrizve.
• A naposzlopot most három publikált dátum rögzíti (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Korábban ezek csak egy kommentben szerepeltek, és semmi sem ellenőrizte őket.

A választás a felügyelők alapján történik, nem a holdházak alapján. A holdházat minden napra visszaadjuk, de nem szűr: az eseménynyilvántartása almanachonként eltér, és nem találjuk ki. Ugyanígy nincsenek megvalósítva a 神煞 táblázatok: ezek tucatnyi egymást átfedő sorozat, a források egyetértése nélkül.