Zeitzonen-Abfrage-API
Senden Sie eine Koordinate und erhalten Sie den Namen der IANA-Zeitzone, den aktuellen UTC-Offset, ob Sommerzeit gilt, und die Ortszeit. Senden Sie zusätzlich einen Zeitstempel und erhalten Sie den Offset, der zu diesem Zeitpunkt galt oder gelten wird, was Sie für Terminplanung und historische Datensätze brauchen.
Beispiel
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=35.6762&lon=139.6503"
# At a specific moment (Unix seconds)
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=40.7128&lon=-74.0060×tamp=1773817200"Speichern Sie den Namen der timezone, nicht den Offset. Offsets ändern sich an vielen Orten zweimal im Jahr und gelegentlich dauerhaft, wenn eine Regierung die Regeln ändert. Der IANA-Name bleibt gültig, und die Regeln werden hier innerhalb eines Tages nach jeder IANA-Veröffentlichung aktualisiert.
{
"status": "ok",
"lat": 35.6762,
"lon": 139.6503,
"timezone": "Asia/Tokyo",
"abbreviation": "JST",
"utc_offset": "+09:00",
"utc_offset_seconds": 32400,
"dst": false,
"timestamp": 1756335245,
"local_time": "2026-08-28T08:34:05+09:00",
"country_code": "JP"
}Was Sie zurückbekommen
| Feld | Bedeutung |
|---|---|
timezone | IANA-Name wie Europe/Berlin. In internationalen Gewässern eine nautische Zone wie Etc/GMT-3. |
abbreviation | Die zum Zeitpunkt geltende Abkürzung: CET, CEST, JST. Weltweit nicht eindeutig; nur zur Anzeige. |
utc_offset, utc_offset_seconds | Der Offset zum Zeitpunkt, als Text und als Zahl. |
dst | Ob zum Zeitpunkt Sommerzeit gilt. |
timestamp, local_time | Der Zeitpunkt, den die Antwort beschreibt, als Unix-Sekunden und als RFC-3339-Zeichenkette in Ortszeit. |
country_code | Das Land, in dem der Punkt liegt, falls vorhanden. |
Wo sie eingesetzt wird
Terminplanung über Standorte hinweg
Senden Sie an jeder Filiale um 9 Uhr morgens Ortszeit eine Erinnerung. Fragen Sie die Zeitzone einmal pro Filiale ab und rechnen Sie mit der tz-Bibliothek Ihrer Programmiersprache um.
Zeitstempel in Protokollen korrigieren
Geräte, die Ortszeit ohne Offset aufzeichnen, lassen sich nachträglich korrigieren, indem Sie den Offset für diesen Zeitpunkt und Ort abfragen.
Nutzern die Ortszeit anzeigen
Zeigen Sie „dort ist es 8:34 Uhr morgens“ neben einem Standort auf einer Karte oder einer Kontaktkarte an.
Preis und Limits
Ein Aufruf, eine Anfrage. Jeder Schlüssel hat 2.500 kostenlose Anfragen pro Tag; darüber hinaus 0,0001 € pro Anfrage aus Prepaid-Guthaben oder nichts mit einem Unlimited-Schlüssel (50 € pro Monat). Preise. Die Formate der Google Time Zone API und von Bing Time Zone sind als Drop-in-Hosts verfügbar.