Conversor de fusos IANA

Informe um carimbo de origem como 2024-06-15T14:30:00, um from_zone de America/New_York e um to_zone de Europe/London, e a ferramenta produz 2024-06-15T19:30:00 como horário local convertido, junto com um carimbo UTC Zulu, um deslocamento com sinal e uma nota de dia civil quando a meia-noite é cruzada. Se qualquer identificador faltar na tabela, a tarefa falha com invalid_input nomeando a zona não reconhecida.

Zonas IANA nomeadas, offsets fixos e por que este conversor não inventa DST

Aliases como US/Eastern, US/Pacific, GB, Japan e rótulos POSIX Etc/GMT mais-ou-menos N resolvem para os mesmos nomes canônicos e minutos. Essa é a promessa do produto por trás da rota de fusos horários: zonas nomeadas, regras fixas, horário local convertido e invalid_input rígido quando um nome não é reconhecido, em vez de uma cidade adivinhada ou um silêncio rumo a UTC.

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 desvio numérico final opcional aceito apenas para analisar os componentes de parede—from_zone permanece o offset de origem autoritativo. Os aliases de datetime incluem dt, time, when, timestamp e datetime_in. O campo from_zone é o identificador IANA de origem e to_zone é o de destino; cada um aceita nomes canônicos Area/Location, aliases herdados comuns, UTC, GMT e rótulos POSIX Etc/GMT com sinal, comparados sem distinção de maiúsculas e com espaços tratados como sublinhados. Os aliases de from_zone incluem from, source_zone, tz_from, timezone_from e from_tz; os de to_zone incluem to, target_zone, tz_to, timezone_to e to_tz. Em caso de sucesso a resposta ecoa datetime_in como carimbo de parede normalizado, datetime_in_iso com o mais-ou-menos HH:MM de origem, datetime_out e datetime_out_iso para o horário local convertido, local_time como HH:MM:SS, from_zone e to_zone como nomes canônicos, from_offset_hours e to_offset_hours como horas arredondadas, rótulos UTC mais-ou-menos coincidentes, offset_diff_hours como destino menos origem, 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, cadeias ISO malformadas, dias de calendário impossíveis como 2023-02-29, horas fora de zero a vinte e três ou um nome de zona não reconhecido—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

Fusos de meia hora e quarto de hora são de primeira classe: Asia/Kolkata são cinco horas e meia, Asia/Kathmandu cinco horas e quarenta e cinco minutos, Australia/Adelaide nove e meia, Pacific/Chatham doze horas e quarenta e cinco minutos. Esta página atende quem busca conversor de fusos horários, converter data-hora entre zonas IANA ou conversão de horário local com zona nomeada; não é calculadora de duração de voo, nem conselheiro de horário de verão, nem deslocador só numérico de offsets UTC, nem ferramenta de intervalo entre cidades que nunca move um carimbo. Prefira esta capacidade quando já tem um carimbo ISO explícito e dois nomes IANA e deseja reprodutibilidade de offset fixo; se só tem rótulos UTC mais-ou-menos numéricos, use o auxiliar de offset a offset; se precisa de horário de verão, use uma ferramenta consciente de DST. Verificações de ida e volta são fáceis: converta A para B e depois B para A com zonas trocadas, e confirme que o relógio de parede original retorna após reconstruir o mesmo instante absoluto. Prefira nomes IANA canônicos quando os tiver (America/New_York, Europe/Berlin, Asia/Tokyo) e deixe a tabela dobrar aliases como US/Eastern ou Japan nos mesmos minutos de offset. Lembre-se de que o deslocamento com sinal é sempre o offset de destino menos o de origem: se a origem é America/New_York em UTC-5 e o destino Europe/London em UTC+0, offset_diff_hours vale mais cinco, assim as catorze e trinta na origem viram dezenove e trinta no mesmo dia civil em Londres. Cruzar a meia-noite define day_offset como mais um ou menos um e day_note explica de que lado o destino cai; uma manhã de Tóquio convertida rumo a Los Angeles costuma pousar no dia civil anterior. Emparelhe exemplos ao ensinar: a mesma zona deixa o relógio igual; conversão para oeste subtrai horas; para leste soma; um nome não reconhecido como Not/A_Zone 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 uma zona inventada.