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