जब कोई ग्रह सूर्य के इतना पास हो कि दिखाई न दे, तो उसे अस्त कहते हैं — asta, यानी 'set' — और शास्त्रीय ग्रंथ मानते हैं कि वह जल गया है और अपना फल नहीं दे सकता। यह एंडपॉइंट किसी एक ग्रह की वे सभी अस्त अवधियाँ लौटाता है, जो दिए गए कैलेंडर वर्ष से ज़रा भी मेल खाती हों।
जाँच सीधी कोणीय दूरी की है। सूर्य से ग्रह की भूकेंद्रीय कोणीय दूरी जब तक उस ग्रह के अपने ऑर्ब से कम रहे, ग्रह अस्त है: मंगल के लिए 17°, मार्गी बुध के लिए 14° और वक्री बुध के लिए 12°, मार्गी शुक्र के लिए 10° और वक्री शुक्र के लिए 8°, बृहस्पति के लिए 11° और शनि के लिए 15°। वर्ष को दोनों सिरों पर थोड़ा आगे-पीछे तक स्कैन किया जाता है, क्योंकि कोई अवधि नए साल के आर-पार फैली हो सकती है, और फिर हर सीमा को द्विभाजन (bisection) से सटीक किया जाता है।
`planet` (mars, mercury, venus, jupiter या saturn) और `year` भेजें। उत्तर `{planet, year, periods, total_asta_days_in_year}` है। इसमें हर अवधि के साथ `start`, `end`, पूरी अवधि का `duration_days`, और उसके उस हिस्से का `days_in_year` होता है, जो आपके पूछे वर्ष में पड़ता है। कोणीय दूरी इस पर निर्भर नहीं करती कि आप कहाँ हैं, इसलिए समय हर जगह एक ही रहते हैं; `timezone_as_float` बस यह तय करता है कि उन्हें किस समय क्षेत्र में दिखाया जाए।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
planet
string
ज़रूरी
marsmercuryvenusjupitersaturn
year
integer
ज़रूरी
जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।
min 1800 · max 2400
latitude
number (double)
वैकल्पिक
स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude
number (double)
वैकल्पिक
स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
timezone_as_float
number (double)
वैकल्पिक
स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।