통서 (택일)

통서(通書)는 전통적으로 길일을 고를 때 쓰는 중국 역서입니다. 그중 두 가지 층은 정확하게 계산할 수 있으며, 여기서 구현한 것이 바로 이 둘입니다: 건제십이신(建除十二神)과 이십팔수(二十八宿).

엔드포인트

엔드포인트	크레딧	반환 내용
`POST /v1/chinese/tong-shu`	10	하루: 일주, 십이신, 수(宿), 충하는 띠
`POST /v1/chinese/tong-shu/select`	20	기간 내에서 규정표가 특정 행위에 적합하다고 보는 날

건제십이신

규칙은 하나입니다. 일지가 월지와 같은 날이 建 Establish이고, 이후 열두 신이 순서대로 돌아갑니다. 여기서 월은 1일이 아니라 절기의 정확한 시점으로 정해지므로, 십이신은 달력상 월 중간에 바뀔 수 있습니다.

#	中文	이름	그날의 성격
1	建	Establish	시작에는 좋지만 마무리에는 좋지 않음
2	除	Remove	치우기, 없애기
3	滿	Full	충만, 계약 체결, 개업
4	平	Balance	평탄하고 일상적이며 무난함
5	定	Stable	오래 지속되어야 하는 일
6	執	Control	손에 넣기
7	破	Destruction	월과 충돌하는 날
8	危	Danger	높은 곳과 위험
9	成	Success	열두 신 중 가장 길한 날
10	收	Collect	거두기, 받기
11	開	Open	열기, 들이기
12	閉	Close	봉하기. 등급이 가장 낮음

이십팔수

수(宿)는 28일로 이루어진 끊김 없는 순환을 따라 매일 바뀌며, 이 순환은 요일에 고정되어 있습니다: 28은 정확히 4주이므로 角은 항상 목요일입니다. 이 성질은 장식이 아니라 그 자체로 검증 수단입니다: 기준점이 잘못되면 공개된 역서에 비해 순서가 밀리거나 요일이 어긋나게 됩니다.

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.

검증 내용

십이신은 공개된 풀이 예시와 대조했습니다: 쥐의 달인 2020년 12월에서 12월 11일이 첫 Establish이고, 12월 8일, 9일, 10일이 각각 Collect, Open, Close입니다. 네 날 모두 일치합니다.
수(宿)는 2026년 8월 일본 역서의 일별 순서와 대조했습니다: 8월 1일의 女부터 8월 20일의 角까지 20일 연속입니다. 여기에 더해 요일 불변식을 100년치 날짜로 검증했습니다.
일주는 이제 공개된 세 날짜(1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰)로 고정되어 있습니다. 이전에는 주석에만 적혀 있었고 아무것도 이를 검증하지 않았습니다.

택일은 십이신 기준이며, 수(宿) 기준이 아닙니다. 수는 매일 반환되지만 필터로 쓰이지는 않습니다: 수에 따른 행위 규정표는 역서마다 다르며, 우리는 이를 지어내지 않습니다. 같은 이유로 神煞(신살) 표도 구현하지 않았습니다: 서로 겹치는 수십 개의 계열이 있고, 출처 간에 합의가 없습니다.

도움이 되었나요?

수정 제안하기

마지막 업데이트: 2026. 9. 25.