किसी ग्रेगोरियन वर्ष के लिए गुजराती वर्ष, जिसमें हर पर्व उस कैलेंडर तारीख़ पर रखा जाता है, जिस दिन वह आपकी दी हुई जगह पर मनाया जाता है। गुजराती कैलेंडर विक्रम संवत वाला अमांत चांद्र-सौर कैलेंडर है, जिसका नया साल वसंत में नहीं, दिवाली के अगले दिन बेसतु वरस पर शुरू होता है, इसलिए वर्ष का ढाँचा बंगाली और असमिया कैलेंडर से अलग है।
चांद्र पर्व पहले तिथि से खोजे जाते हैं, फिर हर पर्व के लिए ज़रूरी समय देखकर उसे सही दिन पर रखा जाता है, और यहाँ यह बाकी कैलेंडरों से ज़्यादा मायने रखता है: कई गुजराती पर्वों की तिथि एक होती है, पर काल अलग, इसलिए गोवर्धन पूजा और बेसतु वरस, या काली चौदस और रूप चौदस, एक ही तिथि पर दिन के अलग-अलग समय पड़ते हैं।
`year` के साथ `latitude`, `longitude` और `timezone_as_float` भेजें। उत्तर `{year, events}` है, जिसमें events तारीख़ के क्रम में `{name, date}` की सूची है, और `date` सादी YYYY-MM-DD स्थानीय कैलेंडर तारीख़ है। सूची लंबी है: बड़े त्योहारों के साथ-साथ इसमें हर महीने की संकष्टी चतुर्थी, एकादशी, कालाष्टमी और दुर्गाष्टमी भी हैं।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
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 से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।
year
integer
ज़रूरी
जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।