API de consulta de zona horaria

Envía una coordenada y obtén el nombre IANA de la zona horaria, el desfase UTC actual, si está en vigor el horario de verano y la hora local. Envía también una marca de tiempo y obtén el desfase que se aplicaba, o que se aplicará, en ese momento, que es lo que necesitas para programar tareas y para registros históricos.

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

Pruébalo en la demo Referencia completa

Ejemplo

Solicitud

$ 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"

Guarda el nombre de timezone, no el desfase. Los desfases cambian dos veces al año en muchos lugares y, en ocasiones, de forma permanente cuando un gobierno cambia las reglas. El nombre IANA sigue siendo válido, y aquí las reglas se actualizan en menos de un día tras cada versión de IANA.

Respuesta

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

Qué recibes

Campo	Significado
`timezone`	Nombre IANA como `Europe/Berlin`. En aguas internacionales, una zona náutica como `Etc/GMT-3`.
`abbreviation`	La abreviatura vigente en la marca de tiempo: `CET`, `CEST`, `JST`. No es única en el mundo; úsala solo para mostrar.
`utc_offset`, `utc_offset_seconds`	El desfase en la marca de tiempo, como texto y como número.
`dst`	Si el horario de verano está en vigor en la marca de tiempo.
`timestamp`, `local_time`	El momento que describe la respuesta, en segundos Unix y como cadena RFC 3339 en hora local.
`country_code`	El país en el que está el punto, si lo hay.

Dónde se usa

Programación entre sedes

Envía un recordatorio a las 9 a. m. hora local en cada tienda. Consulta la zona horaria una vez por tienda y convierte con la biblioteca tz de tu lenguaje.

Corregir marcas de tiempo en registros

Los dispositivos que registran la hora local sin desfase se pueden corregir a posteriori consultando el desfase en esa marca de tiempo y esa ubicación.

Mostrar la hora local a los usuarios

Muestra "allí son las 8:34 a. m." junto a una ubicación en un mapa o en una ficha de contacto.

Precio y límites

Una llamada, una solicitud. Cada clave tiene 2.500 solicitudes gratuitas al día; a partir de ahí, 0,0001 € cada una del crédito prepago, o nada con una clave Unlimited (50 € al mes). Precios. Los formatos de Google Time Zone API y Bing Time Zone están disponibles como hosts compatibles.