通書 (日取り選び)

通書は、伝統的に日取りを選ぶために使われる中国の暦です。そのうち 2 つの層は正確に計算でき、ここで実装しているのはまさにその 2 つです: 十二直 (建除十二神) と 二十八宿。

エンドポイント

エンドポイント	クレジット	返す内容
POST /v1/chinese/tong-shu	10	1 日分: 日柱、十二直、宿、冲する十二支の動物
POST /v1/chinese/tong-shu/select	20	期間内で、暦注が特定の行為に適しているとする日

十二直

規則は 1 つです。日の地支が月の地支と一致する日が 建 Establish で、以降 12 個が順に巡ります。ここでの月は 1 日ではなく節気の正確な時刻で決まるため、十二直は暦の月の途中で切り替わることがあります。

#	中文	名前	その日の性格
1	建	Establish	始めるには良いが、終えるには向かない
2	除	Remove	片付ける、取り除く
3	滿	Full	充実、契約、開業
4	平	Balance	平穏、日常的、無難
5	定	Stable	長く続けるべきこと
6	執	Control	手に取る
7	破	Destruction	月と衝突する日
8	危	Danger	高所と危険
9	成	Success	12 の中で最も吉
10	收	Collect	集める、受け取る
11	開	Open	開く、迎え入れる
12	閉	Close	閉じる。最も格が低い

二十八宿

宿は 28 日の途切れない周期に沿って毎日切り替わり、この周期は曜日に固定されています: 28 はちょうど 4 週間なので、角は常に木曜日です。この性質は飾りではなく、それ自体が検証になります: 基準点が間違っていれば、公開されている暦に対して順序がずれるか、曜日が合わなくなります。

例

1 日分

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

日取り選び

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

行為: marriage、opening、moving、travel、contract、construction、demolition、medical、funeral、education。

ノート

判定は 3 種類で、neutral は “どうでもよい” という意味ではありません。 suitable と unsuitable は暦注が明示している内容です。neutral は、その行為について伝統が何も言っていないことを意味します。そのため、こうした日はデフォルトでは結果に含まれず、includeNeutral で要求できます。

注意

期間は 366 日までで、それより長い期間は切り詰められるのではなく拒否されます。 黙って短縮されたレスポンスは、実際には誰もその先を見ていないのに “3 月以降に良い日はない” と読めてしまいます。レスポンスには常に scanned、matched、dropped とその内訳が含まれるため、合計が合います。

検証済みの内容

• 十二直は公開されている解説例と照合しました: 子の月である 2020 年 12 月では、12 月 11 日が最初の Establish で、12 月 8 日、9 日、10 日がそれぞれ Collect、Open、Close です。4 日すべてが一致します。
• 宿は 2026 年 8 月の日本の暦の日ごとの並びと照合しました: 8 月 1 日の女から 8 月 20 日の角まで、20 日連続です。さらに曜日の不変条件を 100 年分の日付で検証しています。
• 日柱は、公開されている 3 つの日付 (1949-10-01 甲子、2000-01-01 戊午、2024-02-10 甲辰) で固定されました。以前はコメントに書かれていただけで、何によっても検証されていませんでした。

日取り選びは十二直に基づき、宿には基づきません。 宿は毎日返されますが、フィルターには使いません: 宿ごとの吉凶の暦注は暦によって異なり、私たちはそれを創作しません。同じ理由で神煞の表も実装していません: 互いに重なり合う数十の系列があり、出典の間で合意がないためです。