Thư Thông (chọn ngày)

Тун Шу (通書) là một cuốn lịch Trung Quốc, theo đó truyền thống chọn ngày. Hai lớp của nó được tính toán chính xác, và chính chúng được triển khai ở đây: mười hai chỉ huy ngày (建除十二神) và hai mươi tám chỗ đứng (二十八宿).

Các endpoint

Endpoint	Credits	Trả về
POST /v1/chinese/tong-shu	10	Một ngày: cột ngày, chỉ huy, chỗ đứng, con vật va chạm
POST /v1/chinese/tong-shu/select	20	Các ngày trong khoảng, mà sổ đăng ký chấp nhận cho một hành động

Mười hai chỉ huy ngày

Một quy tắc duy nhất. Ngày mà cành địa của nó trùng với cành của tháng, đó là 建 Establish, và sau đó mười hai chỉ huy tiếp tục vòng tròn. Tháng ở đây được xác định bằng thời điểm chính xác của thời tiết mặt trời, không phải ngày đầu tiên, vì vậy chỉ huy có thể thay đổi giữa tháng lịch.

#	中文	Tên	Nội dung ngày
1	建	Establish	Bắt đầu, nhưng không kết thúc
2	除	Remove	Loại bỏ, thoát khỏi
3	滿	Full	Đầy đủ, ký kết, mở đầu
4	平	Balance	Bình thường, thường ngày, an toàn
5	定	Stable	Điều cần kéo dài
6	執	Control	Cầm lấy
7	破	Destruction	Ngày đấu tranh với tháng
8	危	Danger	Cao độ và rủi ro
9	成	Success	Thành công nhất trong mười hai
10	收	Collect	Thu thập, nhận được
11	開	Open	Mở, cho vào
12	閉	Close	Đóng lại; đây là thấp nhất

Hai mươi tám chỗ đứng

Chỗ đứng thay đổi mỗi ngày theo vòng liên tục 28 ngày, và vòng này gắn liền với tuần: 角 luôn là thứ Năm, vì 28 là đúng bốn tuần. Tính năng này không chỉ trang trí, nó là một kiểm tra: mỏ neo sai hoặc dịch chuỗi so với lịch đã công bố, hoặc làm sai ngày trong tuần.

Ví dụ

Một ngày

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

Chọn ngày

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

Các hành động: marriage, opening, moving, travel, contract, construction, demolition, medical, funeral, education.

Ghi chú

Ba phán quyết, và neutral không phải là “bất quan”. suitable và unsuitable là những gì sổ đăng ký nói thẳng. neutral có nghĩa là truyền thống về hành động này im lặng. Vì vậy, các ngày im lặng mặc định không được đưa vào lựa chọn, và bạn có thể yêu cầu chúng qua includeNeutral.

Chú ý

Phạm vi bị giới hạn 366 ngày, và nếu dài hơn sẽ bị loại bỏ, không cắt ngắn. Một câu trả lời rút gọn im lặng sẽ đọc như “sau tháng Ba không còn ngày tốt”, mặc dù thực tế không ai nhìn vào đó. Trong phản hồi luôn có scanned, matched và dropped với chi tiết, vì vậy tổng hợp khớp nhau.

Những gì đã kiểm tra

• Chỉ huy đã được so sánh với ví dụ chi tiết đã công bố: tháng 12 năm 2020 trong tháng Chuột, nơi 11 tháng 12 là Establish đầu tiên, và 8, 9 và 10 tháng 12 là Collect, Open và Close. Bốn mục đều khớp.
• Chỗ đứng đã được so sánh với chuỗi ngày hàng ngày của lịch Nhật cho tháng 8 năm 2026: hai mươi ngày liên tiếp, từ 女 ngày 1 tháng 8 đến 角 ngày 20. Cộng với bất biến của ngày trong tuần, đã kiểm tra trên một thế kỷ ngày.
• Cột ngày giờ đã được xác nhận bằng ba ngày đã công bố (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰). Trước đây chúng chỉ được nhắc trong chú thích và không được kiểm tra gì.

Lựa chọn dựa trên chỉ huy, không phải trên chỗ đứng. Chỗ đứng được trả về cho mỗi ngày, nhưng không lọc: sổ sự kiện của nó khác nhau giữa các lịch, và chúng tôi không tự tạo ra. Tương tự, các bảng 神煞 chưa được triển khai: chúng là hàng chục chuỗi, chồng chéo, không có sự đồng thuận giữa các nguồn.