चीनी राशि चक्र और कैलेंडर

वर्ष का पशु परंपरा का सबसे प्रसिद्ध हिस्सा है और अक्सर गलत तरीके से गिना जाता है। बाज़ी में वर्ष 1 जनवरी से शुरू नहीं होता है और न ही चीनी नव वर्ष से, बल्कि 立春 Lichun से शुरू होता है, वह क्षण जब सूर्य का दृश्यमान देशांतर 315° तक पहुँच जाता है। 2026 में यह 2026-02-03T20:02:08Z है, यानी बीजिंग समय के अनुसार 4 फरवरी को 04:02 बजे। 2 फरवरी को जन्मा व्यक्ति पिछले पशु से संबंधित है, भले ही दीवार पर लगा कैलेंडर पहले से ही नया साल दिखा रहा हो।

एंडपॉइंट्स

एंडपॉइंट	क्रेडिट	क्या लौटाता है
POST /v1/chinese/zodiac/animal	10	वर्ष का पशु, स्तंभ, शाखा और तने के तत्व
POST /v1/chinese/zodiac/element	10	शाखा का स्थिर तत्व और तने का चक्रीय तत्व
POST /v1/chinese/zodiac/inner-animal	10	आंतरिक पशु: माह की शाखा
POST /v1/chinese/zodiac/secret-animal	10	गुप्त पशु: घंटे की शाखा
POST /v1/chinese/zodiac/compatibility	10	三合 और 六冲 के अनुसार दो पशुओं की अनुकूलता
POST /v1/chinese/lunar-date	10	चंद्र तिथि, अधिक मास, चीनी नव वर्ष
POST /v1/chinese/solar-terms	10	वर्ष के सभी 24 पद सेकंड की सटीकता के साथ

तीन पशु, एक नहीं

पत्रिकाओं में राशिफल एक पशु को जानते हैं। परंपरा तीन को जानती है, और वे विभिन्न प्रश्नों का उत्तर देते हैं।

पशु	कहाँ से	क्या अर्थ है
बाहरी	वर्ष की शाखा	लोग व्यक्ति को कैसे देखते हैं
आंतरिक	माह की शाखा	प्रेरणाएँ, निजी “मैं”
गुप्त	घंटे की शाखा	सबसे गहरी परत, अक्सर व्यक्ति से ही छिपी हुई

आंतरिक पशु 節 के सटीक क्षणों तक सीमित है, न कि माह के मध्य तक, इसलिए 5 मई और 6 मई को जन्म लेने से अलग-अलग पशु मिल सकते हैं।

curl -X POST https://api.astroway.info/v1/chinese/zodiac/inner-animal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15","time":"14:30:00","timezoneOffset":3}'

{
  "ok": true,
  "data": {
    "innerAnimal": "Snake",
    "glyph": "🐍",
    "description": "Inner animal = the BaZi month branch, bounded by the exact 節 instants. Represents internal motivations and the private self."
  }
}

वर्ष के दो तत्व

1990 में जन्मा व्यक्ति “धातु का घोड़ा” है, और इस नाम में दो अलग-अलग तत्व हैं जिन्हें आसानी से भ्रमित किया जा सकता है।

• चक्रीय स्वर्गीय तने से आता है और हर दो साल में बदलता है: 庚 धातु है।
• स्थिर हमेशा के लिए सांसारिक शाखा से संबंधित है: 午 अग्नि है, और घोड़ा हमेशा अग्नि का होता है।

/chinese/zodiac/element दोनों को अलग-अलग फ़ील्ड में लौटाता है, fixedElement और cyclingElement, ग्राहक के लिए चुनने के बजाय।

अनुकूलता

मूल्यांकन 三合 (तीन सामंजस्य) और 六冲 (छह टकराव) पर आधारित है, यानी शाखाओं के वृत्त की ज्यामिति पर, न कि विचारों की सूची पर।

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1":{"date":"1990-05-15"},"person2":{"date":"1988-02-20"}}'

{
  "person1": { "solarYear": 1990, "animal": "Horse" },
  "person2": { "solarYear": 1988, "animal": "Dragon" },
  "compatibility": {
    "score": 65,
    "category": "good",
    "notes": ["Compatible enough; complementary differences."]
  }
}

पशुओं की अनुकूलता एक परत है, मानचित्र नहीं

वर्ष के पशुओं की तुलना सबसे मोटा खंड है: यह व्यक्ति के बारे में आठ में से केवल एक ही चित्रलिपि जानता है। वास्तविक पठन के लिए, दोनों का /v1/bazi/chart लें और सभी चार स्तंभों की बातचीत देखें।

चंद्र तिथि

curl -X POST https://api.astroway.info/v1/chinese/lunar-date \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-02-17"}'

{
  "gregorianDate": "2026-02-17",
  "lunar": { "month": 1, "isLeapMonth": false, "day": 1, "monthStart": "2026-02-17", "label": "month 1, day 1" },
  "chineseNewYear": "2026-02-17"
}

माह बीजिंग के उस दिन से शुरू होता है जिसमें अमावस्या होती है। अधिक मास पिछले माह की संख्या को दोहराता है और इसमें 中氣 नहीं होता है: यह इसके अस्तित्व का कारण है, न कि एक दुष्प्रभाव।

1929 से पहले

1929 से पहले का कैलेंडर बीजिंग के स्थानीय माध्य समय (UTC+7:45:40) के अनुसार गिना जाता है, और यह एक ऐतिहासिक आधार है, न कि हमारी परंपरा। अमावस्या, जो स्थानीय मध्यरात्रि के आसपास के मिनटों में पड़ती है, माह को उस दिन के मुद्रित पंचांग से एक दिन आगे रख सकती है, क्योंकि वे दिन की सटीकता के साथ गिने जाते थे।

चौबीस सौर पद

पद तालिका से कोई तिथि नहीं है, बल्कि वह क्षण है जब सूर्य का दृश्यमान देशांतर 15° का गुणज हो जाता है। हम इसे पंचांग से लेते हैं, इसलिए डोमेन के भीतर किसी भी वर्ष के लिए उत्तर समान होता है और इस बात पर निर्भर नहीं करता कि किसी ने तालिका को अपडेट किया है या नहीं।

curl -X POST https://api.astroway.info/v1/chinese/solar-terms \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

एरे terms सभी चौबीस को वहन करता है; यहाँ पहला दिखाया गया है:

{
  "year": 2026,
  "terms": [
    {
      "index": 0,
      "chinese": "立春",
      "pinyin": "Lichun",
      "english": "Start of Spring",
      "sunLongitude": 315,
      "utc": "2026-02-03T20:02:08Z",
      "beijing": "2026-02-04T04:02:08+08:00",
      "opensPillarMonth": true
    }
  ]
}

चौबीस में से बारह में opensPillarMonth: true होता है: ये 節 हैं, जो स्तंभों के माह को खोलते हैं। शेष बारह 中氣 हैं, वे माह को दो भागों में विभाजित करते हैं और निर्धारित करते हैं कि कौन सा माह अधिक मास होगा।

पद एक क्षण है, दिन नहीं, और इसका दिन अलग होता है

यदि आपका उपयोगकर्ता चीन में नहीं है, तो beijing के बजाय utc पढ़ें। चीन और हांगकांग UTC+8 के अनुसार गणना करते हैं, जापान और कोरिया UTC+9 के अनुसार, वियतनाम UTC+7 के अनुसार, इसलिए चौबीस में से एक घंटा वह विंडो है जिसमें राष्ट्रीय पंचांग विभिन्न कैलेंडर दिन छापते हैं। औसतन यह प्रति वर्ष एक पद होता है। 2026 में ये दो हैं: 雨水 बीजिंग में 18 फरवरी और टोक्यो में 19 फरवरी है, 芒種 5 और 6 जून है। हमारे क्षण दोनों प्रकाशनों को मिनट की सटीकता के साथ पुनरुत्पादित करते हैं।

भाषाएँ

पशु और तत्व 21 भाषाओं में अनुवादित हैं। बॉडी में ?lang= या "language" जोड़ें, और अंग्रेजी टोकन के बगल में *Name फ़ील्ड दिखाई देगा:

curl -X POST "https://api.astroway.info/v1/chinese/zodiac/animal?lang=es" \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-05-15"}'

{ "animal": "Horse", "animalName": "Caballo", "element": { "fixed": "Fire", "fixedName": "Fuego" } }

अंग्रेजी फ़ील्ड हमेशा अपनी जगह पर रहते हैं: स्थानीयकरण जोड़ता है, प्रतिस्थापित नहीं करता।