API de fuseau horaire

Envoyez une coordonnée et obtenez le nom IANA du fuseau horaire, le décalage UTC actuel, l'application ou non de l'heure d'été, et l'heure locale. Envoyez aussi un horodatage et obtenez le décalage qui s'appliquait, ou s'appliquera, à ce moment-là, ce dont vous avez besoin pour la planification et les archives historiques.

GEThttps://api.mygeocode.com/v1/timezone?lat=...&lon=...

Essayer dans la démo Référence complète

Exemple

Requête

$ 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&timestamp=1773817200"

Enregistrez le nom du timezone, pas le décalage. Les décalages changent deux fois par an dans de nombreux endroits, et parfois définitivement quand un gouvernement modifie les règles. Le nom IANA reste valide, et les règles sont mises à jour ici dans la journée qui suit chaque publication IANA.

Réponse

{
  "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"
}

Ce que vous recevez

Champ	Signification
`timezone`	Nom IANA tel que `Europe/Berlin`. Dans les eaux internationales, une zone nautique telle que `Etc/GMT-3`.
`abbreviation`	L'abréviation en vigueur à l'horodatage : `CET`, `CEST`, `JST`. Non unique dans le monde ; à utiliser pour l'affichage uniquement.
`utc_offset`, `utc_offset_seconds`	Le décalage à l'horodatage, sous forme de texte et de nombre.
`dst`	Indique si l'heure d'été est en vigueur à l'horodatage.
`timestamp`, `local_time`	Le moment décrit par la réponse, en secondes Unix et sous forme de chaîne RFC 3339 en heure locale.
`country_code`	Le pays dans lequel se trouve le point, le cas échéant.

Où elle est utilisée

Planifier sur plusieurs sites

Envoyez un rappel à 9 h, heure locale, dans chaque magasin. Recherchez le fuseau horaire une fois par magasin et convertissez avec la bibliothèque tz de votre langage.

Corriger les horodatages des journaux

Les appareils qui enregistrent l'heure locale sans décalage peuvent être corrigés après coup en recherchant le décalage applicable à cet horodatage et à cet emplacement.

Afficher l'heure locale aux utilisateurs

Affichez « il est 8:34 h là-bas » à côté d'un lieu sur une carte ou d'une fiche de contact.

Prix et limites

Un appel, une requête. Chaque clé dispose de 2 500 requêtes gratuites par jour ; au-delà, 0,0001 € par requête sur le crédit prépayé, ou rien avec une clé Unlimited (50 € par mois). Tarifs. Les formats Google Time Zone API et Bing Time Zone sont disponibles sous forme d'hôtes compatibles (drop-in).