Calculadora de horário local de chegada
Saindo às 14:30 de UTC−5 e voando 8 horas para UTC+0, você pousa às 03:30 do dia seguinte. Informe o horário de partida, a duração e os dois fusos UTC para ver o horário local de chegada e o dia em que ele cai. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Horário de partida
- 14:30
- Duração em minutos
- 480
- Offset UTC de origem
- -5
- Offset UTC de destino
- 0
- Duração em horas
- 8
- Horário de chegada
- 03:30
- Horário local de chegada
- 03:30
- Deslocamento de dia
- 1
Quando você parte de uma cidade em um horário local conhecido e voa por uma duração fixa para outro offset UTC, o horário de pouso no relógio do destino é aritmética pura — não um mistério dos aplicativos de companhias aéreas. Esta calculadora de horário local de chegada recebe o horário local de partida, a duração do voo em minutos ou horas e os offsets UTC numéricos de origem e destino, e devolve o relógio local do destino e quantos dias de calendário depois (ou antes) você chega.
Entradas: relógio de partida, duração e offsets UTC
O motor rejeita relógios impossíveis — horas fora de zero a vinte e três, minutos ou segundos fora de zero a cinquenta e nove, ou texto livre que não seja um relógio —, para que erros de digitação nunca envolvam silenciosamente outro dia. Os offsets UTC de origem e destino são horas em relação ao Tempo Universal Coordenado: negativos a oeste de Greenwich, positivos a leste, incluindo zonas de meia hora como 5.5 ou a forma de cadeia mais zero cinco dois-pontos trinta.
Os offsets devem ficar entre menos quatorze e mais quatorze horas, o intervalo prático das fusos civis. Este produto intencionalmente não resolve nomes como America/New_York; você fornece o offset que vale na data da viagem para que o resultado permaneça offline, reproduzível e livre de surpresas de horário de verão no meio da requisição.
Como se calculam a chegada e a mudança de dia
Converta o relógio local de partida em minutos a partir da meia-noite. Converta cada offset UTC em minutos com sinal. Some a duração do voo em minutos.
A identidade governante é: minutos locais de chegada iguais a minutos locais de partida menos minutos de offset de origem mais duração mais minutos de offset de destino. Segundos no relógio de partida são aceitos por conveniência, mas a chegada é informada ao minuto, como os viajantes leem as telas de portão.
Casos de uso
Cartões de itinerário de trecho único
Planejadores de viagem transformam relógio de partida, tempo de bloco e dois offsets UTC em uma linha de chegada no destino com um selo explícito de dia seguinte para voos noturnos.
Ajudas de agência e chatbots
Bots de suporte e scripts de agência respondem «a que horas eu pouso?» a partir dos campos do bilhete quando só a partida local, a duração e os offsets são conhecidos.
Perguntas frequentes
Isto trata horário de verão ou zonas IANA?
Não. Você fornece offsets UTC fixos para a data da viagem. Para conversão de zonas IANA de instantes absolutos, use um conversor de fuso horário dedicado.
A calculadora de horário local de chegada é grátis?
A ferramenta do navegador roda grátis no seu dispositivo.
Como informo um fuso de meia hora, como UTC+5:30?
Digite 5,5 ou +05:30; os dois são lidos como cinco horas e meia a leste de UTC. Os fusos vão de −14 a +14 horas, negativos a oeste de Greenwich e positivos a leste.
O que significa chegar no dia seguinte ou no anterior?
Mostra quantos dias de calendário separam partida e chegada com esses fusos: 0 é o mesmo dia, 1 o dia seguinte e um número negativo o dia anterior, o que pode acontecer em trechos longos rumo ao oeste.
Posso informar a duração do voo em horas em vez de minutos?
Pode. Digite minutos inteiros, horas com decimais como 8,5, arredondadas para o minuto mais próximo, ou um valor de horas e minutos como 8:00. São aceitos voos de até sete dias.
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
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/arrival-local-time \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"departure_time":"14:30","origin_utc_offset":-5,"destination_utc_offset":1}'const res = await fetch("https://api.kit.forhosting.com/travel/arrival-local-time", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"departure_time": "14:30",
"origin_utc_offset": -5,
"destination_utc_offset": 1
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/travel/arrival-local-time",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"departure_time": "14:30",
"origin_utc_offset": -5,
"destination_utc_offset": 1
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/travel/arrival-local-time", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"departure_time":"14:30","origin_utc_offset":-5,"destination_utc_offset":1}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"departure_time":"14:30","origin_utc_offset":-5,"destination_utc_offset":1}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/travel/arrival-local-time", 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
{
"departure_time": "14:30",
"origin_utc_offset": -5,
"destination_utc_offset": 1
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "travel.arrival_local_time",
"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
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
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
Cadeias de relógio inválidas, como vinte e cinco horas ou sessenta minutos passados da hora, falham com um erro invalid_input claro e não são cobradas.
Entradas: relógio de partida, duração e offsets UTC
Envie departure_time como cadeia de relógio local de vinte e quatro horas HH:MM ou HH:MM:SS no aeroporto ou cidade de origem. Expresse a duração do voo com duration_minutes em minutos inteiros, com duration_hours em horas (valores fracionários como 8.5 são arredondados ao minuto mais próximo), ou com duration como cadeia H:MM, por exemplo oito dois-pontos zero zero para oito horas. Aliases como departure_local_time, origin_offset e dest_offset são aceitos para que formulários e demos de SDK usem nomes de campo naturais sem remapear. Duração ausente ou qualquer um dos offsets ausente é invalid_input.
Como o horário local de chegada e o day_offset são calculados
Essa quantidade é então dobrada em um relógio de vinte e quatro horas e em um day_offset inteiro: zero significa que o dia de calendário do destino coincide com o da partida sob este modelo puro de offsets; um significa o dia seguinte; valores negativos indicam o dia anterior em trechos para o oeste ultralongos ou com offset pesado. A resposta ecoa departure_time, duration_minutes, duration_hours, ambos os offsets, arrival_time e arrival_local_time como HH:MM com zeros à esquerda, day_offset, um rótulo curto day_offset_label como same_day ou next_day, a cadeia formula e method utc_offset_minute_arithmetic. Exemplo: parta às quatorze e trinta de UTC menos cinco, voe oito horas para UTC mais zero e pousa às zero três e trinta com day_offset um. A duração é limitada a sete dias em minutos para manter isolados do Worker limitados; totais de várias semanas devem ser divididos fora desta calculadora.
Uso da API, preços, itinerários e limites práticos
Chame a calculadora gratuita de horário local de chegada no navegador ao planejar um único trecho, conferir um bilhete eletrônico impresso ou ensinar como offsets civis e tempo de voo decorrido se combinam. As entradas de origem seguem as mesmas regras de retenção de outros itens parse de KIT. Mantenha os offsets honestos para a data da viagem se origem ou destino observam horário de verão; o motor não inventará transições DST por você. Envie um corpo JSON com o relógio de partida obrigatório, um campo de duração e ambos os offsets UTC. Use a API pré-paga quando uma ferramenta de agência de viagens, um gerador de lista de bagagem, um construtor de viagem multi-cidade ou uma planilha de sala de aula precisar de um contrato estável sob saldo KIT a US$ 0,002 por item bem-sucedido; falhas de validação nunca consomem saldo após o motor rejeitar a requisição. Combine este endpoint com um conversor geral de fuso horário quando você já tiver um instante absoluto e IDs de zona IANA, e use esta calculadora quando as entradas forem um relógio local de partida, um tempo de bloco e dois offsets numéricos — a intenção de SEO que viajantes digitam na busca. Autores que distribuem SDKs podem mapear arrival_time e day_offset diretamente em cartões de itinerário que mostrem «pousa amanhã às 03:30 hora local» sem embutir um banco completo de zonas no cliente.
Casos de integração
Problemas de sala de aula e exames
Professores propõem problemas de texto sobre horário civil e duração decorrida; a API devolve day_offset estruturado e HH:MM para correção automática sem casos-limite de Date.
Perguntas técnicas
Como calculo o horário local de chegada a partir de um voo?
Envie departure_time (HH:MM), duration_minutes ou duration_hours, origin_utc_offset e destination_utc_offset. A resposta inclui arrival_time e day_offset.
O que conta como horário inválido?
Cadeias de relógio com horas fora de 0–23, minutos ou segundos fora de 0–59, ou que não tenham forma HH:MM falham com invalid_input e não são cobradas.
O que significa day_offset?
day_offset é quantos dias de calendário somar à data de partida sob este modelo de offsets: 0 same_day, 1 next_day, negativo para chegadas no dia anterior.