Convertir hora entre desfases UTC

Introduzca un sello de origen como 2024-06-15T14:30:00, un from_offset de más dos horas y un to_offset de menos cinco horas, y la herramienta obtiene 2024-06-15T07:30:00 en el destino con un sello UTC Zulu coincidente, el desplazamiento horario con signo y una nota de día de calendario cuando se cruza la medianoche.

Desfaces UTC fijos frente a zonas con nombre y por qué importa convertir el reloj de pared

Catorce horas es el límite exterior práctico de los desfaces civiles reales en uso amplio; los valores fuera de ese rango se tratan como errores de entrada y fallan con invalid_input antes de cualquier conversión.

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_offset sigue siendo el desfase de origen autoritativo para la conversión. Los alias de datetime incluyen dt, time, when, timestamp y datetime_in. El campo from_offset es el desfase fijo de origen en horas y to_offset es el de destino; cada uno acepta un número finito como dos, menos cinco o cinco coma cinco, o una cadena como más cero dos dos puntos cero cero o menos cero cinco dos puntos treinta, y cada uno debe estar entre menos catorce y más catorce horas inclusive. Los alias de from_offset incluyen from, offset_from, source_offset y utc_from; los de to_offset incluyen to, offset_to, target_offset y utc_to. En caso de éxito la respuesta repite datetime_in como sello de pared normalizado sin sufijo de desfase, datetime_in_iso con el ±HH:MM de origen, from_offset y to_offset como horas redondeadas, from_offset_label y to_offset_label como cadenas cortas UTC±, offset_diff_hours como destino menos origen, datetime_out y datetime_out_iso para el reloj de destino, 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 puede mostrar junto a la respuesta. La validación fallida—campos ausentes, desfaces no finitos, desfaces fuera de ±14, cadenas ISO mal formadas, días de calendario imposibles como 2023-02-29 u horas fuera de cero a veintitrés—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

Recuerde que el desplazamiento con signo es siempre to_offset menos from_offset: si el origen es UTC más dos y el destino UTC menos cinco, offset_diff_hours es menos siete, así que las catorce treinta en el origen se convierten en las siete treinta el mismo día de calendario en el destino. Cruzar la medianoche fija day_offset en más uno o menos uno y day_note explica de qué lado cae el destino. Empareje ejemplos al enseñar: el mismo desfase deja el reloj igual; la conversión hacia el oeste de horas enteras resta horas; hacia el este suma; un desfase de media hora produce treinta minutos de cambio; un desfase fuera de rango 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 el desfase quince.