ForHosting KIT · Utilidades de desarrollo

Diferencia horaria entre ciudades

Una calculadora de diferencia horaria entre ciudades responde a la pregunta cotidiana de viaje y de llamada: si en una ciudad es una hora local dada, ¿qué hora es en la otra y cuántas horas separan esos dos relojes?

● BetaGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

Usted nombra ambas ciudades y aporta el desfase UTC fijo de cada una en horas—menos cinco para New York en hora estándar, más nueve para Tokyo, más doce para Auckland, menos diez para Honolulu—más la hora local y el minuto opcional en la primera ciudad. El motor devuelve la diferencia horaria con signo, ambos relojes locales como HH:MM, el desplazamiento de día de calendario tras el wrap de medianoche, un wrap por el camino más corto en una ventana de más o menos doce horas, y una marca que indica cuándo los dos desfases distan más de medio día, que es la firma civil de un cruce de la línea de cambio de fecha. Los desfases fuera de más o menos catorce horas se rechazan. La aritmética es determinista: sin red, sin reloj del anfitrión, sin base de zonas IANA y sin adivinar el horario de verano, de modo que el ejecutor gratuito del navegador y la API coinciden siempre.

Cómo usarla

Ingrese sus datos en el formulario de arriba. La herramienta los revisa antes de calcular y muestra el resultado en la misma página.

Revise sus datos

Use las etiquetas y unidades indicadas en cada campo. Si falta algo o un valor está fuera del rango permitido, la página señala qué debe corregir.

Repita el cálculo o automatícelo

Use la herramienta web para comprobaciones individuales y la API cuando necesite integrar la misma capacidad en un flujo automatizado.

Qué puede hacer con ella

Obtenga una respuesta ahora

Ingrese un conjunto de valores y vea el resultado sin preparar una hoja de cálculo ni un script.

Compare escenarios

Cambie un valor a la vez y repita el cálculo para entender qué modifica el resultado.

Automatice el trabajo repetido

Use la API cuando necesite ejecutar el mismo cálculo dentro de su producto o flujo.

Preguntas frecuentes

¿Cómo uso esta capacidad?

Complete los campos de arriba y ejecútela en esta página. El formulario señala cualquier dato que deba corregir.

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/travel/time-difference-cities

¿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/travel/time-difference-cities \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}'

const res = await fetch("https://api.kit.forhosting.com/travel/time-difference-cities", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "city_a": "New York",
    "utc_a": -5,
    "city_b": "Tokyo",
    "utc_b": 9,
    "hour": 15
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/travel/time-difference-cities",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "city_a": "New York",
    "utc_a": -5,
    "city_b": "Tokyo",
    "utc_b": 9,
    "hour": 15
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/time-difference-cities", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"city_a":"New York","utc_a":-5,"city_b":"Tokyo","utc_b":9,"hour":15}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/time-difference-cities", 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

{
  "city_a": "New York",
  "utc_a": -5,
  "city_b": "Tokyo",
  "utc_b": 9,
  "hour": 15
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "travel.time_difference_cities",
  "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.

Límites

`max_abs_offset_hours`	14
`max_city_len`	80

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 →