घड़ी के हिसाब से लिखे जन्म समय और निर्देशांकों से एक ऐसा क्षण निकालता है, जिसमें कोई संदेह न रहे। यहाँ का हर दूसरा एंडपॉइंट या तो समय क्षेत्र वाला टाइमस्टैम्प माँगता है या UTC ऑफ़सेट की संख्या, और इसी में गलती होने से कुंडली चुपचाप एक घंटा या एक दिन खिसक जाती है। इसलिए आम तौर पर पहली कॉल यही होती है।
`date`, `time`, `latitude` और `longitude` भेजें। निर्देशांकों से IANA समय क्षेत्र निकाला जाता है, बिना ज़ोन वाली तारीख़ और समय उसी ज़ोन में पढ़े जाते हैं, और आपको `input_datetime`, तय हुए `timezone` का नाम, ऑफ़सेट सहित `localized_datetime`, और `utc_datetime` मिलते हैं। स्थानीय समय वाली वैल्यू सीधे दूसरे एंडपॉइंट के `date_time` में दें।
एक सावधानी: अनुरोध फ़ील्ड की वर्तनी `use_LMT` है, पर व्यू दूसरी वर्तनी वाला नाम पढ़ता है, इसलिए स्थानीय माध्य समय कभी लागू नहीं होता और हमेशा IANA ज़ोन ही लगता है — उत्तर में `use_lmt` हमेशा false रहता है। जिस जगह मानक समय बाद में अपनाया गया, वहाँ उससे पहले के जन्मों के लिए इस फ़्लैग पर भरोसा न करें; स्थानीय माध्य समय का ऑफ़सेट ख़ुद निकालें (देशांतर के हर अंश पर चार मिनट)।
अनुरोध के फ़ील्ड
फ़ील्ड
टाइप
ज़रूरी
टिप्पणी
date
string (date)
ज़रूरी
यह फ़ॉर्मैट की शर्त है, enum नहीं। डिफ़ॉल्ट इनपुट फ़ॉर्मैट वाला DRF DateField = केवल ISO-8601: 'YYYY-MM-DD'।
latitude
number (double)
ज़रूरी
स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
min -180 · max 180
longitude
number (double)
ज़रूरी
स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
min -180 · max 180
time
string (time)
ज़रूरी
यह फ़ॉर्मैट की शर्त है, enum नहीं। डिफ़ॉल्ट इनपुट फ़ॉर्मैट वाला DRF TimeField = केवल ISO-8601: 'HH:MM', 'HH:MM:SS' या 'HH:MM:SS.ffffff'। कैटलॉग की नमूना वैल्यू "string" भ्रम में डालती है।