टुन शु (तारीख चयन)

Тун Шу (通書) एक चीनी अल्मनैक है, जिसके आधार पर पारंपरिक रूप से दिन चुना जाता है। इसके दो पहलू सटीक रूप से गणना किए जाते हैं, और वही यहाँ लागू किए गए हैं: बारह दिन के शासक (建除十二神) और अठाईस स्थितियां (二十八宿).

एंडपॉइंट्स

एन्डपॉइंट	क्रेडिट	क्या लौटाता है
POST /v1/chinese/tong-shu	10	एक दिन: दिन का स्तंभ, शासक, स्थिति, टकराव जानवर
POST /v1/chinese/tong-shu/select	20	एक कार्रवाई के लिए रजिस्टर द्वारा स्वीकृत रेंज में दिन

बारह दिन के शासक

नियम एक है। वह दिन, जिसकी पृथ्वी शाखा महीने की शाखा से मेल खाती है, वह 建 Establish है, और फिर बारह क्रम में घूमते हैं। यहाँ महीना सौर अवधि के सटीक क्षण से निर्धारित होता है, न कि पहले दिन से, इसलिए शासक कैलेंडर महीने के बीच में बदल सकता है।

#	中文	नाम	दिन के बारे में
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 ठीक चार सप्ताह होते हैं। यह गुण सजावटी नहीं है, यह ही जाँच है: गलत एंकर या क्रम को प्रकाशित अल्मनैक के सापेक्ष शिफ्ट करना, या सप्ताह के दिन को तोड़ना।

उदाहरण

एक दिन

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.

टिप्पणी

तीन निर्णय, और neutral का मतलब ‘उदासीन’ नहीं है। suitable और unsuitable वही हैं जो रजिस्टर सीधे कहता है। neutral का अर्थ है कि इस कार्रवाई के बारे में परंपरा चुप है। इसलिए चुप दिन डिफ़ॉल्ट रूप से चयन में नहीं आते, और उन्हें includeNeutral के माध्यम से माँगा जा सकता है।

सावधानी

रेंज 366 दिनों तक सीमित है, और लंबी रेंज को घटाया नहीं जाता, बल्कि अस्वीकार किया जाता है। चुप्पी में संक्षिप्त उत्तर पढ़ा जाएगा जैसे “मार्च के बाद अच्छे दिन नहीं हैं”, जबकि वास्तव में कोई भी वहाँ नहीं देखता था। उत्तर में हमेशा scanned, matched और dropped विभाजन के साथ होते हैं, इसलिए कुल मिलाकर बराबर रहता है।

क्या जांचा गया

• शासक प्रकाशित विस्तृत उदाहरण से मिलाए गए: दिसंबर 2020 चूहे के महीने में, जहाँ 11 दिसंबर पहला Establish है, और 8, 9 और 10 दिसंबर क्रमशः Collect, Open और Close हैं। सभी चार मेल खाते हैं।
• स्थितियां को अगस्त 2026 के जापानी अल्मनैक की दैनिक क्रम से मिलाया गया: लगातार बीस दिन, 女 से 1 अगस्त से लेकर 角 तक 20 अगस्त। साथ ही सप्ताह के दिन का इनवेरिएंट, जो सदी के डेटों पर जाँच किया गया।
• दिन का स्तंभ अब तीन प्रकाशित तिथियों (1949-10-01 甲子, 2000-01-01 戊午, 2024-02-10 甲辰) से स्थिर है। पहले इन्हें केवल टिप्पणी में नाम दिया गया था और कुछ नहीं जाँचा गया।

चयन शासकों के आधार पर होता है, स्थितियों पर नहीं। स्थिति हर दिन लौटती है, लेकिन फ़िल्टर नहीं करती: इसका इवेंट रजिस्टर अल्मनैक के बीच भिन्न होता है, और हम इसे नहीं बनाते। उसी तरह 神煞 तालिकाएँ लागू नहीं की गई हैं: ये कई श्रृंखलाएँ हैं जो ओवरलैप करती हैं, स्रोतों के बीच सहमति नहीं है।