Convertidor de zonas IANA

Indique un sello de origen como 2024-06-15T14:30:00, un from_zone de America/New_York y un to_zone de Europe/London, y la herramienta obtiene 2024-06-15T19:30:00 como hora local convertida, junto con un sello UTC Zulu, un desplazamiento con signo y una nota de día de calendario cuando se cruza la medianoche. Si falta cualquiera de los identificadores en la tabla, la tarea falla con invalid_input nombrando la zona no reconocida.

Zonas IANA con nombre, offsets fijos y por qué este convertidor no inventa DST

Alias como US/Eastern, US/Pacific, GB, Japan y las etiquetas POSIX Etc/GMT más-o-menos N se resuelven a los mismos nombres canónicos y minutos. Esa es la promesa del producto detrás de la ruta de zonas horarias: zonas con nombre, reglas fijas, hora local convertida e invalid_input duro cuando un nombre no se reconoce, en lugar de una ciudad adivinada o un silencio hacia UTC.

Cómo llamar a la API y cómo leer cada campo de la respuesta

Envíe un cuerpo JSON con tres campos obligatorios. El campo datetime es una cadena de reloj de pared ISO-8601: año de cuatro dígitos, mes, día, separador T o espacio, horas y minutos, segundos opcionales, fracciones de segundo opcionales truncadas a segundos enteros, y un Z o desfase numérico final opcional que solo se acepta para analizar los componentes de pared—from_zone sigue siendo el offset de origen autoritativo. Los alias de datetime incluyen dt, time, when, timestamp y datetime_in. El campo from_zone es el identificador IANA de origen y to_zone es el de destino; cada uno acepta nombres canónicos Area/Location, alias heredados habituales, UTC, GMT y etiquetas POSIX Etc/GMT con signo, comparados sin distinción de mayúsculas y con espacios tratados como guiones bajos. Los alias de from_zone incluyen from, source_zone, tz_from, timezone_from y from_tz; los de to_zone incluyen to, target_zone, tz_to, timezone_to y to_tz. En caso de éxito la respuesta repite datetime_in como sello de pared normalizado, datetime_in_iso con el más-o-menos HH:MM de origen, datetime_out y datetime_out_iso para la hora local convertida, local_time como HH:MM:SS, from_zone y to_zone como nombres canónicos, from_offset_hours y to_offset_hours como horas redondeadas, etiquetas UTC más-o-menos coincidentes, offset_diff_hours como destino menos origen, utc_iso para el mismo instante en Zulu, year month day hour minute second como enteros del reloj civil de destino, day_offset por cuántas medianoches se cruzaron, day_note y message como resúmenes breves, formula como identidad de una línea, y steps como arreglo ordenado de líneas de sustitución que usted puede mostrar junto a la respuesta. La validación fallida—campos ausentes, cadenas ISO mal formadas, días de calendario imposibles como 2023-02-29, horas fuera de cero a veintitrés o un nombre de zona no reconocido—devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición correcta con unidad item.

Consejos prácticos, límites, búsquedas relacionadas y dónde encaja esta herramienta

Las zonas de media hora y cuarto de hora son de primera clase: Asia/Kolkata son cinco horas y media, Asia/Kathmandu cinco horas cuarenta y cinco minutos, Australia/Adelaide nueve y media, Pacific/Chatham doce horas cuarenta y cinco minutos. Esta página atiende a quien busca convertidor de zonas horarias, convertir fecha-hora entre zonas IANA o conversión de hora local con zona nombrada; no es calculadora de duración de vuelo, ni asesor de horario de verano, ni desplazador solo numérico de desfaces UTC, ni herramienta de hueco entre ciudades que nunca mueve un sello. Prefiera esta capacidad cuando ya tiene un sello ISO explícito y dos nombres IANA y desea reproducibilidad de offset fijo; si solo tiene etiquetas UTC más-o-menos numéricas, use el ayudante de desfase a desfase; si necesita horario de verano, use una herramienta consciente del DST. Las comprobaciones de ida y vuelta son fáciles: convierta A a B y luego B a A con zonas intercambiadas, y confirme que vuelve el reloj de pared original tras reconstruir el mismo instante absoluto. Prefiera nombres IANA canónicos cuando los tenga (America/New_York, Europe/Berlin, Asia/Tokyo) y deje que la tabla pliegue alias como US/Eastern o Japan sobre los mismos minutos de offset. Recuerde que el desplazamiento con signo es siempre el offset de destino menos el de origen: si el origen es America/New_York a UTC-5 y el destino Europe/London a UTC+0, offset_diff_hours vale más cinco, así que las catorce treinta en el origen se convierten en las diecinueve treinta el mismo día de calendario en Londres. Cruzar la medianoche fija day_offset en más uno o menos uno y day_note explica de qué lado cae el destino; una mañana de Tokio convertida hacia Los Ángeles suele aterrizar en el día de calendario anterior. Empareje ejemplos al enseñar: la misma zona deja el reloj igual; la conversión hacia el oeste resta horas; hacia el este las suma; un nombre no reconocido como Not/A_Zone demuestra la ruta dura de invalid_input. Las tareas fallidas con invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando se envía a propósito una zona inventada.