Diferença de fuso UTC

Offsets fora de mais ou menos quatorze horas são rejeitados com invalid_input. O caminho é determinístico—sem rede, sem sementes aleatórias, sem Date de relógio de parede—assim o executor gratuito do navegador e a API pré-paga devolvem o mesmo JSON após arredondamento fixo sempre.

Offsets UTC fixos versus fusos nomeados

Ao manter o contrato em números fixos no intervalo fechado de menos quatorze a mais quatorze horas, a ferramenta fica previsível para planilhas, testes de API e notas de viagem que já imprimem rótulos UTC±.

Como chamar a API e ler a resposta

Envie um corpo JSON com os números finitos obrigatórios offset_a e offset_b (aliases incluem a, from_offset, offset_from, utc_a para o primeiro, e b, to_offset, offset_to, utc_b para o segundo), cada um entre menos quatorze e mais quatorze inclusive, mais o inteiro obrigatório hour_a de zero a vinte e três para a hora local em A. O opcional minute_a tem padrão zero e deve ser um inteiro de zero a cinquenta e nove quando presente. Em sucesso a resposta ecoa os offsets arredondados e o relógio de entrada, publica offset_a_label e offset_b_label como strings curtas UTC±, define hour_diff como offset_b menos offset_a, abs_diff_hours como o valor absoluto dessa diferença, hour_b e minute_b e time_b para o relógio mapeado em B, day_offset para quantas meias-noites foram cruzadas ao somar a diferença, day_note e direction como resumos curtos, message como resultado de uma linha, e steps como um array ordenado de linhas de substituição. Validação falha—campos ausentes, números não finitos, hora ou minuto não inteiros, hora fora de zero a vinte e três, minuto fora de zero a cinquenta e nove, ou qualquer offset cujo valor absoluto exceda quatorze horas—retorna invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item e preço unitário marginal zero.

Dicas práticas, limites e buscas relacionadas

Mantenha os offsets dentro da janela publicada de mais ou menos quatorze horas; valores como quinze ou menos quatorze vírgula um são rejeitados para que chamadores não inventem offsets civis impossíveis. Prefira horas fracionárias para zonas de meia hora e três quartos de hora—cinco vírgula cinco para a Índia, cinco vírgula sete cinco para o Nepal, nove vírgula cinco para partes da Austrália—em vez de esconder minutos em um segundo campo que não existe para o offset em si. Esta página atende quem busca diferença de offset de fuso, horas de offset UTC entre dois lugares ou hora local dados dois offsets fixos; não é calculadora de duração de voo, nem conselheiro de horário de verão, nem conversor de zona por nome de cidade. Prefira esta capacidade quando ambos os lados já publicam rótulos UTC± fixos; se você só tem nomes de cidade, resolva os offsets primeiro ou use uma ferramenta de zona com horário de verão. Ao mapear um relógio local, lembre que a diferença com sinal é sempre B menos A: se A é UTC mais dois e B é UTC menos cinco, hour_diff é menos sete, então quinze e trinta em A vira oito e trinta no mesmo dia do calendário em B. Cruzar a meia-noite define day_offset como mais um ou menos um e a string day_note explica de que lado da meia-noite B cai em relação a A. Emparelhe exemplos ao ensinar: o mesmo offset deixa o relógio inalterado; viagem para o oeste de horas inteiras subtrai horas; para o leste soma horas; um offset de meia hora produz um deslocamento de trinta minutos; um offset fora da faixa demonstra o caminho duro de invalid_input. Tarefas falhas que retornam invalid_input não consomem saldo pré-pago, o que mantém scripts exploratórios baratos quando aprendizes enviam de propósito offset quinze. Checagens de ida e volta são fáceis: recalcule à mão offset_b menos offset_a e confirme que é igual a hour_diff, depois some essas horas a time_a e confirme que time_b e day_offset batem após o wrap de vinte e quatro horas.