Tong Shu (wybór daty)

Tong Shu (通書) to chiński almanach, według którego tradycyjnie wybiera się dzień. Dwie jego warstwy dają się obliczyć dokładnie i to właśnie one są tu zaimplementowane: dwunastu oficerów dnia (建除十二神) i dwadzieścia osiem stacji księżycowych (二十八宿).

Endpointy

Endpoint	Kredyty	Co zwraca
POST /v1/chinese/tong-shu	10	Jeden dzień: filar dnia, oficer, stacja, zwierzę konfliktu
POST /v1/chinese/tong-shu/select	20	Dni w zakresie, które rejestr uznaje za dobre dla jednej czynności

Dwunastu oficerów dnia

Reguła jest jedna. Dzień, którego gałąź ziemska pokrywa się z gałęzią miesiąca, to 建 Establish, a dalej dwunastu idzie po kolei w kółko. Miesiąc wyznacza tu dokładny moment okresu słonecznego, a nie pierwszy dzień miesiąca, więc oficer może zmienić się w połowie miesiąca kalendarzowego.

#	中文	Nazwa	O czym jest dzień
1	建	Establish	Początek, ale nie zakończenie
2	除	Remove	Uprzątnąć, pozbyć się
3	滿	Full	Pełnia, podpisanie, otwarcie
4	平	Balance	Równy, zwyczajny, bezpieczny
5	定	Stable	To, co ma trwać
6	執	Control	Wziąć w swoje ręce
7	破	Destruction	Dzień, który ściera się z miesiącem
8	危	Danger	Wysokość i ryzyko
9	成	Success	Najkorzystniejszy z dwunastu
10	收	Collect	Zebrać, otrzymać
11	開	Open	Otworzyć, wpuścić
12	閉	Close	Zapieczętować; najniżej oceniany

Dwadzieścia osiem stacji księżycowych

Stacja zmienia się codziennie w nieprzerwanym cyklu 28 dni, a ten cykl jest związany z tygodniem: 角 to zawsze czwartek, bo 28 to dokładnie cztery tygodnie. Ta własność nie jest ozdobnikiem, to właśnie ona jest sprawdzianem: błędna kotwica albo przesunęłaby sekwencję względem opublikowanego almanachu, albo zepsułaby dzień tygodnia.

Przykład

Jeden dzień

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

Wybór daty

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

Czynności: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Notatka

Trzy werdykty, a neutral nie znaczy “obojętnie”. suitable i unsuitable to to, co rejestr mówi wprost. neutral oznacza, że tradycja milczy na temat tej czynności. Dlatego dni “milczące” domyślnie nie trafiają do wyników, a można o nie poprosić przez includeNeutral.

Uwaga

Zakres jest ograniczony do 366 dni, a dłuższy jest odrzucany, a nie przycinany. Po cichu skrócona odpowiedź czytałaby się jak “po marcu nie ma dobrych dni”, choć w rzeczywistości nikt tam nie zaglądał. Odpowiedź zawsze zawiera scanned, matched i dropped z podziałem, więc suma się zgadza.

Co zostało sprawdzone

• Oficerowie porównani z opublikowanym, rozpisanym przykładem: grudzień 2020 w miesiącu Szczura, gdzie 11 grudnia to pierwszy Establish, a 8, 9 i 10 grudnia to Collect, Open i Close. Wszystkie cztery się zgadzają.
• Stacje porównane z dzienną sekwencją japońskiego almanachu na sierpień 2026: dwadzieścia dni z rzędu, od 女 pierwszego sierpnia do 角 dwudziestego. Do tego niezmiennik dnia tygodnia, sprawdzony na stuleciu dat.
• Filar dnia jest teraz przypięty trzema opublikowanymi datami (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Wcześniej były one wymienione tylko w komentarzu i niczym niesprawdzane.

Wybór opiera się na oficerach, a nie na stacjach. Stacja jest zwracana dla każdego dnia, ale nie filtruje: jej rejestr zdarzeń różni się między almanachami, a my go nie wymyślamy. Z tego samego powodu nie są zaimplementowane tabele 神煞: to dziesiątki nakładających się serii bez zgody między źródłami.