Diferencia de huso UTC

Los desfaces fuera de más o menos catorce horas se rechazan con invalid_input. La ruta es determinista—sin red, sin semillas aleatorias, sin Date de reloj de pared—así que el ejecutor gratuito del navegador y la API prepago devuelven el mismo JSON tras un redondeo fijo cada vez.

Desfaces UTC fijos frente a zonas horarias con nombre

Al limitar el contrato a números fijos en el intervalo cerrado de menos catorce a más catorce horas, la herramienta se mantiene predecible para hojas de cálculo, pruebas de API y notas de viaje que ya imprimen etiquetas UTC±.

Cómo llamar a la API y leer la respuesta

Envíe un cuerpo JSON con los números finitos obligatorios offset_a y offset_b (los alias incluyen a, from_offset, offset_from, utc_a para el primero, y b, to_offset, offset_to, utc_b para el segundo), cada uno entre menos catorce y más catorce inclusive, más el entero obligatorio hour_a de cero a veintitrés para la hora local en A. El opcional minute_a vale cero por defecto y debe ser un entero de cero a cincuenta y nueve cuando esté presente. En caso de éxito la respuesta repite los desfaces redondeados y el reloj de entrada, publica offset_a_label y offset_b_label como cadenas cortas UTC±, fija hour_diff a offset_b menos offset_a, abs_diff_hours al valor absoluto de esa diferencia, hour_b y minute_b y time_b para el reloj mapeado en B, day_offset por cuántas medianoches se cruzaron al sumar la diferencia, day_note y direction como resúmenes breves, message como resultado de una línea, y steps como un arreglo ordenado de líneas de sustitución. La validación fallida—campos ausentes, números no finitos, hora o minuto no enteros, hora fuera de cero a veintitrés, minuto fuera de cero a cincuenta y nueve, o cualquier desfase cuyo valor absoluto supere catorce horas—devuelve invalid_input y nunca se cobra. El precio es un $0.002 fijo por petición correcta con unidad item y precio unitario marginal cero.

Consejos prácticos, límites y búsquedas relacionadas

Mantenga los desfaces dentro de la ventana publicada de más o menos catorce horas; valores como quince o menos catorce coma uno se rechazan para que los llamadores no inventen desfaces civiles imposibles. Prefiera horas fraccionarias para zonas de media hora y tres cuartos de hora—cinco coma cinco para la India, cinco coma siete cinco para Nepal, nueve coma cinco para partes de Australia—en lugar de colar minutos en un segundo campo que no existe para el desfase en sí. Esta página atiende a quien busca diferencia de desfase horario, horas de desfase UTC entre dos lugares u hora local dados dos desfaces fijos; no es una calculadora de duración de vuelo, ni un asesor de horario de verano, ni un convertidor de zonas por nombre de ciudad. Prefiera esta capacidad cuando ambos extremos ya publican etiquetas UTC± fijas; si solo tiene nombres de ciudad, resuelva primero los desfaces o use una herramienta de zona con horario de verano. Al mapear un reloj local, recuerde que la diferencia con signo es siempre B menos A: si A es UTC más dos y B es UTC menos cinco, hour_diff es menos siete, así que las quince treinta en A se convierten en las ocho treinta el mismo día de calendario en B. Cruzar la medianoche fija day_offset en más uno o menos uno y la cadena day_note explica de qué lado de la medianoche cae B respecto a A. Empareje ejemplos al enseñar: el mismo desfase deja el reloj sin cambios; un viaje hacia el oeste de horas enteras resta horas; hacia el este suma horas; un desfase de media hora produce un desplazamiento de treinta minutos; un desfase fuera de rango demuestra la ruta dura de invalid_input. Las tareas fallidas que devuelven invalid_input no consumen saldo prepago, lo que mantiene baratos los scripts exploratorios cuando los aprendices envían a propósito desfase quince. Las comprobaciones de ida y vuelta son fáciles: recalcule a mano offset_b menos offset_a y confirme que iguala hour_diff, luego sume esas horas a time_a y confirme que time_b y day_offset coinciden tras el wrap de veinticuatro horas.