ForHosting KIT · Utilidades de desarrollo

Hora local desde un desfase UTC

La calculadora de hora local desde un desfase UTC convierte una hora conocida en UTC en la hora de reloj correspondiente a una ciudad cuando usted ya conoce su desfase fijo.

● BetaGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

Introduzca la hora UTC, una etiqueta de ciudad y los componentes con signo de horas y minutos. El resultado indica la hora local y si corresponde al día anterior, al mismo día o al siguiente. No intervienen búsquedas de zona horaria, conexiones de red, el reloj del sistema ni supuestos sobre el horario de verano.

Introduzca la hora UTC de referencia y la ciudad

Comience con una hora expresada en tiempo universal coordinado y escríbala en el formato estricto de 24 horas HH:MM. La medianoche es 00:00, el mediodía es 12:00 y el último minuto válido es 23:59. El campo de ciudad identifica el resultado; no solicita una búsqueda geográfica. Por ejemplo, indicar Katmandú no hace que la calculadora consulte un servicio de zonas horarias ni decida qué desfase está vigente. Usted debe facilitar el desfase apropiado para la fecha y las circunstancias. Esta separación es importante porque algunas ciudades cambian por el horario de verano, los gobiernos pueden modificar la hora civil y los desfases históricos pueden diferir de los actuales. Consulte una fuente oficial, determine primero el desfase aplicable y después úselo junto con la hora UTC. El formato estricto evita valores ambiguos y la etiqueta de ciudad permite mostrar el resultado con claridad en agendas, informes y paneles sin afirmar que la ubicación haya sido verificada.

Indique los componentes del desfase UTC con signo

Escriba la parte de horas enteras en offset_hours y los minutos restantes en offset_minutes. Los valores positivos corresponden a relojes adelantados respecto de UTC y los negativos, a relojes atrasados. Un desfase +05:45 se representa con 5 horas y 45 minutos; uno de -03:30, con -3 horas y -30 minutos. Los dos componentes distintos de cero deben tener el mismo signo para expresar con claridad la dirección. Para un desfase negativo inferior a una hora, use cero horas y minutos negativos. El intervalo completo admitido va de -12:00 a +14:00. Los minutos deben ser números enteros entre -59 y 59; no se redondean fracciones ni se trasladan automáticamente minutos excesivos. Tras validar los datos, la calculadora convierte todo el desfase a minutos con signo y lo suma a los minutos transcurridos desde la medianoche UTC. Así admite desfases de media hora o de un cuarto de hora sin aritmética decimal imprecisa.

Interprete la hora local y el cambio de día

El campo local_time contiene la hora convertida en formato de 24 horas HH:MM con ceros iniciales. day_offset explica la relación entre el día local y el día de la hora UTC: -1 indica el día anterior, 0 el mismo día y 1 el día siguiente. Un desfase positivo aplicado al final del día puede cruzar la medianoche, mientras que uno negativo poco después de la medianoche UTC puede retroceder de fecha. Como la calculadora no recibe una fecha, no inventa mes, día de la semana ni fecha resultante; usted puede aplicar day_offset a una fecha conocida mediante el sistema de calendario adecuado. La respuesta conserva la ciudad, ambas horas y los componentes del desfase, por lo que el cálculo se puede auditar sin interpretar texto. El algoritmo solo usa enteros acotados y no depende de la configuración regional, la zona horaria del equipo ni la hora actual. Los datos no válidos producen un error tipificado. El uso de la API cuesta $0.002 por solicitud y el mismo cálculo puede ejecutarse en el navegador.

Qué puede hacer con ella

Preparar una reunión remota

Convierta una hora de reunión acordada en UTC al reloj de la ciudad de un participante cuando ya conoce el desfase aplicable.

Crear un itinerario

Muestre la hora del destino y conserve el indicador de cambio de día en una agenda construida a partir de registros UTC.

Normalizar paneles operativos

Transforme horas de eventos UTC en vistas de ciudades con desfase fijo sin depender de la zona horaria del servidor.

Preguntas frecuentes

¿La calculadora averigua el desfase UTC actual de una ciudad?

No. Usted proporciona el desfase y la ciudad funciona como etiqueta descriptiva del resultado.

¿Tiene en cuenta el horario de verano?

No. Introduzca el desfase fijo que corresponda al lugar y la fecha después de considerar cualquier regla estacional.

¿Cómo se introduce un desfase UTC-03:30?

Use -3 en offset_hours y -30 en offset_minutes para que ambos componentes indiquen un retraso respecto de UTC.

¿Qué significa day_offset?

Vale -1 para el día anterior, 0 para el mismo día o 1 para el día siguiente con respecto a la referencia UTC.

¿Cuánto cuesta una solicitud por API?

Cada solicitud por API cuesta $0.002. El cálculo determinista también puede ejecutarse directamente en el navegador.

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/date/local-time-from-offset

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/date/local-time-from-offset \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}'

const res = await fetch("https://api.kit.forhosting.com/date/local-time-from-offset", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/date/local-time-from-offset",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "utc_time": "18:45",
    "city": "Kathmandu",
    "offset_hours": 5
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/date/local-time-from-offset", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"utc_time":"18:45","city":"Kathmandu","offset_hours":5}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/date/local-time-from-offset", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Ejemplo de solicitud

{
  "utc_time": "18:45",
  "city": "Kathmandu",
  "offset_hours": 5
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "date.local_time_from_offset",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →