समय क्षेत्र लुकअप
किसी बिंदु का समय क्षेत्र, और किसी दिए गए क्षण पर वहाँ लागू ऑफ़सेट।
GEThttps://api.mygeocode.com/v1/timezone
पैरामीटर
| पैरामीटर | प्रकार | विवरण |
|---|---|---|
latज़रूरी* | number | -90 से 90। |
lonज़रूरी | number | -180 से 180। |
locationsवैकल्पिक | string | *lat और lon का विकल्प: lat,lon|lat,lon|... के रूप में अधिकतम 100 बिंदु। हर बिंदु एक अनुरोध के रूप में गिना जाता है; जवाब में इनपुट के क्रम में एक results array होता है। |
tzवैकल्पिक | string | *निर्देशांकों का विकल्प: Europe/Zurich जैसी IANA ज़ोन id (Windows id भी स्वीकार की जाती है)। सीमा लुकअप के बिना उस ज़ोन के लिए वही फ़ील्ड लौटाता है। |
timestampवैकल्पिक | integer | सेकंड में Unix समय। डिफ़ॉल्ट: अभी। 1900 से 2100 तक का कोई भी क्षण स्वीकार किया जाता है; भविष्य के ऑफ़सेट अभी प्रकाशित नियमों का उपयोग करते हैं। |
languageवैकल्पिक | string | name के लिए भाषा, जैसे de या pt-BR। डिफ़ॉल्ट अंग्रेज़ी। |
keyवैकल्पिक | string | API कुंजी, अगर हेडर के रूप में नहीं भेजी गई। |
उदाहरण
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=-33.8688&lon=151.2093×tamp=1767225600"const url = new URL("https://api.mygeocode.com/v1/timezone");
url.searchParams.set("lat", -33.8688);
url.searchParams.set("lon", 151.2093);
url.searchParams.set("timestamp", 1767225600); // 2026-01-01T00:00:00Z
const tz = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(tz.timezone, tz.utc_offset, tz.dst);import requests
tz = requests.get("https://api.mygeocode.com/v1/timezone",
params={"lat": -33.8688, "lon": 151.2093, "timestamp": 1767225600}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5).json()
print(tz["timezone"], tz["utc_offset"], tz["dst"])रिस्पॉन्स
{
"status": "ok",
"lat": -33.8688,
"lon": 151.2093,
"timezone": "Australia/Sydney",
"abbreviation": "AEDT",
"utc_offset": "+11:00",
"utc_offset_seconds": 39600,
"dst": true,
"timestamp": 1767225600,
"local_time": "2026-01-01T11:00:00+11:00",
"country_code": "AU",
"next_transition": { "timestamp": 1775316000, "utc_offset": "+10:00", "dst": false }
}रिस्पॉन्स फ़ील्ड
| फ़ील्ड | प्रकार | विवरण |
|---|---|---|
timezone | string | IANA नाम। अंतरराष्ट्रीय जल में Etc/GMT+n या Etc/GMT-n (ध्यान दें कि चिह्न की परंपरा उल्टी है, जैसा IANA में है)। |
abbreviation | string | timestamp पर संक्षिप्त नाम। केवल दिखाने के लिए; अनोखा नहीं। |
name | string | timestamp पर लागू पूरा नाम, जैसे Australian Eastern Daylight Time। |
utc_offset | string | timestamp पर ±HH:MM। |
utc_offset_seconds | integer | वही, संख्या के रूप में। |
raw_offset_seconds, dst_offset_seconds | integer | मानक ऑफ़सेट और उसके ऊपर डेलाइट सेविंग वाला हिस्सा (DST लागू न होने पर 0)। दोनों का योग utc_offset_seconds है। |
dst | boolean | timestamp पर डेलाइट सेविंग लागू है। |
timestamp | integer | वर्णित क्षण। |
local_time | string | ऑफ़सेट के साथ RFC 3339 स्थानीय समय। |
country_code | string या null | ISO 3166-1 alpha-2, समुद्र में null। |
is_ocean | boolean | अंतरराष्ट्रीय जल में इस्तेमाल होने वाले Etc/GMT ज़ोन के लिए true। |
windows_timezone | string या null | CLDR से मेल खाती Windows समय क्षेत्र id, जैसे W. Europe Standard Time। |
next_transition | object या null | timestamp के बाद अगला ऑफ़सेट बदलाव, अगर ज़ोन में कोई हो। |
टिप्पणियाँ
- IANA नाम सहेजें और अपने प्लेटफ़ॉर्म के tz डेटाबेस से समय बदलें। ऑफ़सेट फ़ील्ड का उपयोग दिखाने के लिए या उन सिस्टम के लिए करें जिनके पास tz डेटाबेस नहीं है।
- ऑफ़सेट और डेलाइट सेविंग के नियम IANA समय क्षेत्र डेटाबेस के अनुसार होते हैं और नई रिलीज़ प्रकाशित होने पर अपडेट किए जाते हैं।
- सीमाएँ लगभग 55 m तक सरल की गई हैं, इसलिए किसी ज़मीनी सीमा से कुछ मीटर के भीतर का बिंदु पड़ोसी ज़ोन में आ सकता है। क्षेत्रीय जल और खुला समुद्र भी कवर हैं; तट से दूर के बिंदुओं को समुद्री ज़ोन मिलता है (
Etc/GMT+3आदि)।
यही लुकअप दूसरे प्रदाताओं के फ़ॉर्मैट में
अगर आपके पास इनमें से किसी प्रदाता के लिए पहले से लिखा कोड है, तो उसे रखें: ड्रॉप-इन होस्ट वही पाथ और पैरामीटर स्वीकार करता है और उस प्रदाता के रिस्पॉन्स ढाँचे में जवाब देता है, जिसके पीछे यही एंडपॉइंट होता है। ड्रॉप-इन कैसे काम करते हैं देखें।
| प्रदाता | होस्ट | पाथ |
|---|---|---|
| Google Maps प्लैटफ़ॉर्म | gapi.mygeocode.com | /maps/api/timezone/json?location=lat,lng×tamp=...&language=.. |
| Bing Maps REST सेवाएँ | bing.mygeocode.com | /REST/v1/TimeZone/{lat},{lon}?datetime=.../REST/v1/TimeZone/?query=lat,lon/REST/v1/TimeZone/List?timezoneStandard=iana|windows/REST/v1/TimeZone/Convert?datetime=...&fromtz=...&desttz=... |
| LocationIQ | locationiq.mygeocode.com | /v1/timezone?lat=...&lon=... |
एरर
400 invalid_request जब lat या lon गायब हो या सीमा से बाहर हो, tz कोई ज्ञात ज़ोन न हो, 100 से ज़्यादा बिंदु हों, या timestamp 1900 से 2100 के बाहर हो। 503 unavailable जब सीमा डेटा लोड न हुआ हो; कुछ भी गिना नहीं जाता।