Tong Shu (Datumswahl)

Tong Shu (通書) ist der chinesische Almanach, nach dem traditionell ein Tag gewählt wird. Zwei seiner Ebenen lassen sich exakt berechnen, und genau die sind hier implementiert: die zwölf Tagesoffiziere (建除十二神) und die achtundzwanzig Mondhäuser (二十八宿).

Endpoints

Endpoint	Credits	Was er liefert
POST /v1/chinese/tong-shu	10	Ein Tag: Tagessäule, Offizier, Mondhaus, Konflikttier
POST /v1/chinese/tong-shu/select	20	Die Tage in einem Zeitraum, die das Register für eine Aktivität gutheißt

Zwölf Tagesoffiziere

Es gibt nur eine Regel. Der Tag, dessen Erdzweig mit dem Zweig des Monats übereinstimmt, ist 建 Establish, danach folgen die zwölf im Kreis. Der Monat wird hier durch den exakten Moment des Sonnenterms bestimmt, nicht durch den Monatsersten; der Offizier kann also mitten im Kalendermonat wechseln.

#	中文	Name	Wofür der Tag steht
1	建	Establish	Anfang, aber kein Abschluss
2	除	Remove	Aufräumen, loswerden
3	滿	Full	Fülle, Unterzeichnung, Eröffnung
4	平	Balance	Ausgeglichen, alltäglich, sicher
5	定	Stable	Was Bestand haben soll
6	執	Control	In die Hand nehmen
7	破	Destruction	Der Tag, der mit dem Monat kollidiert
8	危	Danger	Höhe und Risiko
9	成	Success	Der günstigste der zwölf
10	收	Collect	Sammeln, empfangen
11	開	Open	Öffnen, hereinlassen
12	閉	Close	Versiegeln; der niedrigste von allen

Achtundzwanzig Mondhäuser

Das Mondhaus wechselt täglich auf einem durchgehenden Kreis von 28 Tagen, und dieser Kreis ist an die Woche gekoppelt: 角 fällt immer auf einen Donnerstag, weil 28 genau vier Wochen sind. Diese Eigenschaft ist keine Dekoration, sie ist die Prüfung selbst: Ein falscher Anker würde entweder die Folge gegenüber dem veröffentlichten Almanach verschieben oder den Wochentag brechen.

Beispiel

Ein Tag

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

Datumswahl

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

Aktivitäten: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Hinweis

Drei Urteile, und neutral heißt nicht “egal”. suitable und unsuitable ist das, was das Register ausdrücklich sagt. neutral bedeutet, dass die Tradition zu dieser Aktivität schweigt. Deshalb landen schweigende Tage standardmäßig nicht in der Auswahl; du kannst sie mit includeNeutral anfordern.

Achtung

Der Zeitraum ist auf 366 Tage begrenzt, und ein längerer wird abgelehnt, nicht abgeschnitten. Eine stillschweigend gekürzte Response würde sich lesen wie “nach März gibt es keine guten Tage”, obwohl in Wirklichkeit niemand nachgesehen hat. Die Response enthält immer scanned, matched und dropped mit Aufschlüsselung, die Summe geht also auf.

Was geprüft ist

• Die Offiziere sind mit einem veröffentlichten, durchgerechneten Beispiel abgeglichen: Dezember 2020 im Monat der Ratte, in dem der 11. Dezember das erste Establish ist und der 8., 9. und 10. Dezember Collect, Open und Close. Alle vier stimmen überein.
• Die Mondhäuser sind mit der Tagesfolge eines japanischen Almanachs für August 2026 abgeglichen: zwanzig Tage am Stück, von 女 am ersten August bis 角 am zwanzigsten. Dazu kommt die Wochentags-Invariante, geprüft über ein Jahrhundert an Daten.
• Die Tagessäule ist jetzt durch drei veröffentlichte Daten festgeschrieben (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Vorher standen sie nur in einem Kommentar und wurden durch nichts geprüft.

Die Auswahl läuft über die Offiziere, nicht über die Mondhäuser. Das Mondhaus wird für jeden Tag zurückgegeben, filtert aber nicht: Sein Ereignisregister unterscheidet sich zwischen den Almanachen, und wir erfinden es nicht. Ebenso sind die 神煞-Tabellen nicht implementiert: Das sind Dutzende sich überlappender Reihen, ohne Einigkeit zwischen den Quellen.