ForHosting KIT · Viagens e geografia

Diferença horária entre cidades

Às 15:00 em Nova York (UTC−5) são 05:00 do dia seguinte em Tóquio (UTC+9), uma diferença de 14 horas. Digite as duas cidades, seus offsets UTC e a hora local para marcar uma ligação ou planejar uma viagem. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Cidade A: New York
Utc a: -5
Cidade B: Tokyo
Utc b: 9
Hora: 15
Minuto: 0

Você obtém

Rótulo UTC de A: UTC-5
Rótulo UTC de B: UTC+9
Hora em A: 15:00
Hora em B: 05:00

Uma calculadora de diferença de horário entre cidades responde à pergunta cotidiana de viagem e de ligação: se em uma cidade é uma hora local dada, que horas são na outra e quantas horas separam esses dois relógios? Você informa os dois nomes e o offset UTC fixo de cada cidade em horas—menos cinco para New York no horário padrão, mais nove para Tokyo, mais doze para Auckland, menos dez para Honolulu—mais a hora local e o minuto opcional na primeira cidade. O motor devolve a diferença horária com sinal, ambos os relógios locais como HH:MM, o deslocamento de dia civil após o wrap da meia-noite, um wrap pelo caminho mais curto em uma janela de mais ou menos doze horas, e uma marca que indica quando os dois offsets ficam a mais de meio dia, a assinatura civil de um cruzamento da linha de mudança de data. Offsets fora de mais ou menos catorze horas são recusados.

Como o intervalo de horas e os dois relógios locais são calculados

Todo relógio civil de uma cidade pode ser escrito como um offset fixo em relação ao Tempo Universal Coordenado quando você já conhece o horário sazonal que importa. New York no Eastern Standard Time é UTC menos cinco; Tokyo é UTC mais nove; Delhi é UTC mais cinco e meio; Adelaide é UTC mais nove e meio; Kathmandu é UTC mais cinco e três quartos.

Esta calculadora nunca pesquisa esses números por você: digite os nomes das cidades como rótulos e os dois offsets em horas, depois informe a hora local—e, se quiser, o minuto—já mostrada no relógio da primeira cidade. A diferença horária com sinal é sempre o offset da cidade B menos o offset da cidade A. Essa única subtração é o número de horas que se somam à hora local da primeira cidade para obter a hora local da segunda no mesmo instante.

O trabalho segue em minutos inteiros para que fusos de meia hora e de um quarto de hora continuem exatos: a diferença é multiplicada por sessenta e arredondada ao minuto mais próximo, depois somada a hora vezes sessenta mais minuto. O total de minutos é dobrado de volta a um relógio de vinte e quatro horas.

O que resta depois de remover os dias completos é o HH:MM na cidade B; o número de dias completos removidos é o deslocamento de dia civil, que pode ir de menos dois a mais dois nos extremos reais de UTC menos catorze e UTC mais catorze. Quando as duas cidades compartilham o offset, os relógios coincidem e o deslocamento de dia é zero.

Quando não, a resposta nomeia qual cidade está adiantada, imprime os dois relógios e lista os passos de substituição para você conferir a aritmética à mão antes de marcar uma ligação ou uma reunião.

Virada de dia ao cruzar a Linha Internacional de Data

A Linha Internacional de Data é a costura civil perto de cento e oitenta graus de longitude onde a data do calendário salta. Cidades no flanco leste dessa costura usam offsets positivos grandes, como UTC mais doze em Auckland, UTC mais treze em Samoa ou UTC mais catorze nas Line Islands. As do flanco oeste usam offsets negativos grandes, como UTC menos dez em Honolulu, UTC menos onze em American Samoa ou UTC menos doze em Baker Island.

Subtrair esses offsets pode produzir um intervalo maior que doze horas e, nos extremos, maior que vinte e quatro, de modo que somar o intervalo a um relógio local pode cair não só no dia anterior ou no seguinte, mas a dois dias de distância. Pares clássicos ilustram o contrato.

Quinze horas em New York a UTC menos cinco são cinco da manhã do dia civil seguinte em Tokyo a UTC mais nove, um intervalo de mais catorze horas que marca a linha de data e se envolve a menos dez horas pelo outro lado. Meio-dia em Auckland a UTC mais doze são catorze horas do dia anterior em Honolulu a UTC menos dez, um intervalo de menos vinte e duas horas que se envolve a mais duas.

Nove da manhã em Samoa a UTC mais treze são nove da manhã do dia anterior em American Samoa a UTC menos onze: o mesmo mostrador, vinte e quatro horas e um dia civil de diferença. Use esses campos quando precisar dizer a um viajante se deve escrever terça ou quarta no cartão de embarque, e não só o que o relógio de parede vai marcar.

Casos de uso

Agendar uma ligação do outro lado do oceano

Escolha uma hora local na sua cidade, informe o offset UTC da outra e leia os dois relógios mais a nota de dia civil antes de enviar o convite da reunião.

Conferir o dia de viagem ao cruzar a linha de data

Compare Auckland com Honolulu ou Samoa com American Samoa e veja se o calendário de destino é ontem, hoje ou dois dias além.

Colocar relógios de cidade em um briefing de viagem

Rotule duas cidades, fixe os offsets UTC± publicados e deixe o par HH:MM e o intervalo de horas no itinerário sem abrir uma base de fusos.

Perguntas frequentes

Como encontro a diferença de horário entre duas cidades?

Informe os dois nomes, o offset UTC fixo de cada cidade em horas e a hora local na primeira.

Por que o dia civil pode diferir se os relógios parecem próximos?

Ao cruzar a linha de data o intervalo bruto pode ser de 22 ou 24 horas. Os mostradores podem parecer só duas horas apartados, ou até idênticos, enquanto a cidade B está no dia anterior ou no seguinte.

Esta ferramenta consulta fusos a partir do nome da cidade?

Não. Os nomes das cidades são só rótulos de exibição. Você informa os offsets UTC fixos. O motor não chama uma base de fusos, não aplica DST e não lê o relógio do anfitrião.

Como considero o horário de verão?

Escolha os offsets da estação que interessa antes de digitá-los. A calculadora usa os offsets fixos que você informa: Nova York é menos cinco no horário padrão, e no verão você deve informar o offset de verão.

Funciona com fusos de meia hora e de quarto de hora?

Sim. Os offsets podem ser fracionários, como mais cinco e meia para Délhi, mais nove e meia para Adelaide ou mais cinco e três quartos para Katmandu. O cálculo é feito em minutos inteiros, então esses fusos ficam exatos.

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/travel/time-difference-cities

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

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)

Exemplo de requisição

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

Exemplo de resposta

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

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`max_abs_offset_hours`	14
`max_city_len`	80

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Notas técnicas

A aritmética é determinística: sem rede, sem relógio do anfitrião, sem base de zonas IANA e sem adivinhar o horário de verão, de modo que o executor gratuito do navegador e a API sempre coincidem.

Virada de dia ao cruzar a Linha Internacional de Data

Este endpoint trata essa situação como dado de primeira classe, não como um detalhe tardio. O campo hour_diff é o intervalo bruto com sinal. O campo hour_diff_wrapped projeta esse intervalo no representante único do intervalo semiaberto de menos doze a mais doze, o caminho mais curto ao redor do relógio de vinte e quatro horas. O booleano crosses_date_line é verdadeiro exatamente quando o intervalo bruto absoluto é estritamente maior que doze horas: o teste civil de que os dois relógios ficam a mais de meio dia.

Contrato de entrada, erros e quando esta página é a ferramenta certa

A intenção de busca aqui é a consulta de consumidor diferença de horário entre cidades, não uma identidade crua de offset de fuso nem um relógio de chegada por duração de voo. Resolva o horário de verão você mesmo antes de escolher os offsets, ou use um conversor de zona nomeada quando só tiver identificadores IANA. Envie um corpo JSON com cinco campos obrigatórios e um opcional. city_a e city_b são nomes não vazios de no máximo oitenta caracteres após o recorte; são rótulos do resultado, não chaves de uma base de fusos. utc_a e utc_b são offsets UTC finitos em horas, inclusive de menos catorze a mais catorze, e podem ser fracionários para que Índia, Nepal e os fusos australianos de meia hora continuem honestos. hour é a hora local inteira na cidade A em um relógio de vinte e quatro horas de zero a vinte e três. minute é opcional, vale zero por padrão e deve ser um inteiro de zero a cinquenta e nove quando presente. Alias são aceitos no transporte: from_city, city ou a_name para city_a; to_city ou b_name para city_b; offset_a, from_offset ou utc_from para utc_a; offset_b, to_offset ou utc_to para utc_b; hour_a, h ou local_hour para hour; minute_a, m ou local_minute para minute. Nomes ausentes, cadeias vazias, offsets não finitos, horas ou minutos fora da faixa, hour ou minute não inteiros, e qualquer offset cujo valor absoluto ultrapasse catorze horas falham com invalid_input nomeando o campo; essas falhas não são cobradas. Em sucesso, o corpo ecoa as cidades, os offsets arredondados, os rótulos UTC±, o relógio de entrada, ambas as cadeias HH:MM, os intervalos horário com sinal, absoluto e envolvido, day_offset e day_label, a marca da linha de data, ahead_city e behind_city, uma mensagem de uma linha e os passos ordenados. Chamadas API bem-sucedidas custam US$ 0,002 por requisição; entrada inválida não consome saldo pré-pago.

Perguntas técnicas

O que significa crosses_date_line?

É verdadeiro quando a diferença horária absoluta é maior que 12. Esse teste civil marca relógios a mais de meio dia de distância, a assinatura usual de um par do Pacífico ou da linha de data.

Quanto custa a calculadora de diferença de horário entre cidades?

A ferramenta do navegador é gratuita. Requisições API usam saldo KIT pré-pago a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis

Exemplo resolvido

Como o intervalo de horas e os dois relógios locais são calculados

Virada de dia ao cruzar a Linha Internacional de Data

Casos de uso

Agendar uma ligação do outro lado do oceano

Conferir o dia de viagem ao cruzar a linha de data

Colocar relógios de cidade em um briefing de viagem

Perguntas frequentes

Ferramentas relacionadas

Para desenvolvedores — acesso via API

Endpoint

Chame do seu código

Exemplo de requisição

Exemplo de resposta

Preço

Limites

Erros

Notas técnicas

Virada de dia ao cruzar a Linha Internacional de Data

Contrato de entrada, erros e quando esta página é a ferramenta certa

Perguntas técnicas

obrigado