Converter hora entre offsets UTC

Informe um carimbo de origem como 2024-06-15T14:30:00, um from_offset de mais duas horas e um to_offset de menos cinco horas, e a ferramenta produz 2024-06-15T07:30:00 no destino com um carimbo UTC Zulu correspondente, o deslocamento horário com sinal e uma nota de dia civil quando a meia-noite é cruzada.

Offsets UTC fixos versus zonas nomeadas e por que a conversão do relógio de parede importa

Catorze horas é o limite externo prático dos offsets civis reais em uso amplo; valores fora desse intervalo são tratados como erros de entrada e falham com invalid_input antes de qualquer conversão.

Como chamar a API e como ler cada campo da resposta

Envie um corpo JSON com três campos obrigatórios. O campo datetime é uma cadeia de relógio de parede ISO-8601: ano de quatro dígitos, mês, dia, separador T ou espaço, horas e minutos, segundos opcionais, frações de segundo opcionais truncadas a segundos inteiros, e um Z ou offset numérico final opcional aceito apenas para analisar os componentes de parede—from_offset permanece o offset de origem autoritativo para a conversão. Os aliases de datetime incluem dt, time, when, timestamp e datetime_in. O campo from_offset é o offset fixo de origem em horas e to_offset é o de destino; cada um aceita um número finito como dois, menos cinco ou cinco ponto cinco, ou uma cadeia como mais zero dois dois pontos zero zero ou menos zero cinco dois pontos trinta, e cada um deve estar entre menos catorze e mais catorze horas inclusive. Os aliases de from_offset incluem from, offset_from, source_offset e utc_from; os de to_offset incluem to, offset_to, target_offset e utc_to. Em caso de sucesso a resposta ecoa datetime_in como carimbo de parede normalizado sem sufixo de offset, datetime_in_iso com o ±HH:MM de origem, from_offset e to_offset como horas arredondadas, from_offset_label e to_offset_label como cadeias curtas UTC±, offset_diff_hours como destino menos origem, datetime_out e datetime_out_iso para o relógio de destino, utc_iso para o mesmo instante em Zulu, year month day hour minute second como inteiros do relógio civil de destino, day_offset por quantas meias-noites foram cruzadas, day_note e message como resumos breves, formula como identidade de uma linha, e steps como arranjo ordenado de linhas de substituição que você pode mostrar junto da resposta. Validação falha—campos ausentes, offsets não finitos, offsets fora de ±14, cadeias ISO malformadas, dias de calendário impossíveis como 2023-02-29 ou horas fora de zero a vinte e três—devolve invalid_input e nunca é cobrada. O preço é um US$ 0,002 fixo por requisição bem-sucedida com unidade item.

Dicas práticas, limites, buscas relacionadas e onde esta ferramenta se encaixa

Lembre-se de que o deslocamento com sinal é sempre to_offset menos from_offset: se a origem é UTC mais dois e o destino UTC menos cinco, offset_diff_hours é menos sete, assim as catorze e trinta na origem viram sete e trinta no mesmo dia civil no destino. Cruzar a meia-noite define day_offset como mais um ou menos um e day_note explica de que lado o destino cai. Emparelhe exemplos ao ensinar: o mesmo offset deixa o relógio igual; conversão para oeste em horas inteiras subtrai horas; para leste soma; um offset de meia hora produz trinta minutos de mudança; um offset fora da faixa demonstra o caminho rígido de invalid_input. Tarefas falhas com invalid_input não consomem saldo pré-pago, o que mantém baratos os scripts exploratórios quando se envia de propósito o offset quinze.