नित्य योग, सूर्य और चंद्रमा के निरयन भोगांशों के जोड़ से बने वृत्त का सत्ताईसवाँ भाग है। सत्ताईस योगों में से हर एक — विष्कंभ से वैधृति तक — एक दिन से थोड़ा कम चलता है, और मुहूर्त चुनने में इनका महत्व है: व्यतीपात, वैधृति, परिघ, व्याघात, शूल, गंड और अतिगंड पारंपरिक रूप से टाले जाते हैं, जबकि सिद्धि, सिद्ध, शुभ, अमृत वर्ग के और सुकर्मा योग ढूँढे जाते हैं। यह एंडपॉइंट नाम से एक योग लेता है और कैलेंडर वर्ष में वह जितनी बार आता है, हर बार की अवधि लौटाता है।
`yoga_name` केस-संवेदी है और enum से हूबहू मेल खाना चाहिए। `year` और `timezone_as_float` तय करते हैं कि कौन-सा स्थानीय वर्ष देखना है; निर्देशांक नहीं चाहिए, क्योंकि योग हर जगह एक ही क्षण बदलता है। दोनों भोगांशों का जोड़ हर 22.6 घंटे में लगभग 13 अंश 20 कला बढ़ता है, इसलिए हर योग साल में लगभग चौदह या पंद्रह बार आता है।
उत्तर `{year, yoga_name, rows}` है, जिसमें `rows` समय के क्रम में `{start, end}` की सूची है, UTC ISO टाइमस्टैम्प में। हर जोड़ा उस योग के शुरू और ख़त्म होने का असली क्षण है, जो सूर्योदय के समय का नमूना लेकर नहीं, सूर्य और चंद्रमा के भोगांशों के जोड़ पर द्विभाजन (bisection) से निकाला जाता है, इसलिए सीमाएँ एक सेकंड के अंश तक सटीक होती हैं।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
timezone_as_float
number (double)
ज़रूरी
स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।
year
integer
ज़रूरी
जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।