Minutos para fuso UTC

Ele utiliza somente o valor que você envia; portanto, o resultado nunca depende da data atual, do relógio do dispositivo, do idioma do navegador, da localização geográfica, das regras de horário de verão nem de um banco de dados de fusos horários. A saída sempre inclui o prefixo UTC, um sinal explícito, dois dígitos de hora, dois-pontos e dois dígitos de minuto, sendo adequada para telas de configuração, registros normalizados, testes, logs e intercâmbio de dados.

Informe o fuso em minutos inteiros com sinal

Forneça um único inteiro chamado minutes. Valores positivos representam horários adiantados em relação a UTC, valores negativos representam horários atrasados e zero indica ausência de diferença. Por exemplo, 330 descreve cinco horas e trinta minutos adiantados, enquanto -240 descreve quatro horas atrasadas. Usar minutos na entrada elimina a ambiguidade das horas decimais: 5.5 horas pode ser compreensível para uma pessoa, mas 330 minutos é exato e dispensa interpretação de ponto flutuante. O intervalo aceito vai de -840 a 840, correspondendo a UTC-14:00 e UTC+14:00 e abrangendo o limite prático dos fusos UTC civis. O formatador rejeita frações, strings numéricas, valores ausentes, números não finitos e valores fora desse intervalo, sem arredondar ou converter silenciosamente. Essa validação rigorosa protege configurações e agendamentos contra mudanças sutis no fuso pretendido por você. Calcule ou obtenha o valor correto antes da chamada; a capacidade não o deduz de cidade, país, abreviação, nome de zona, instante ou configuração do dispositivo. Assim, entradas inteiras iguais percorrem sempre a mesma formatação.

Entenda o resultado canônico UTC±HH:MM

O algoritmo escolhe o sinal diretamente da entrada, usa sua magnitude absoluta, separa horas inteiras e minutos restantes e completa ambos os componentes com dois dígitos. A entrada 330 vira UTC+05:30, -75 vira UTC-01:15 e 60 vira UTC+01:00. O zero é representado como UTC+00:00 para manter a mesma estrutura fixa de todos os resultados; não há abreviação especial Z nem rótulo UTC reduzido. Os dois-pontos estão sempre presentes, e nenhum componente é omitido quando vale zero. Esse formato estável atende bem a interfaces, snapshots de teste, configurações exportadas, documentação gerada e sistemas que comparam strings normalizadas. A resposta também devolve offset_minutes, preservando a entrada numérica validada ao lado do fuso formatado. Você pode exibir a string e manter o inteiro para ordenação, cálculos ou armazenamento, sem precisar interpretar o texto novamente. Aqui, a palavra canônico descreve o formato documentado desta capacidade: UTC em maiúsculas, sinal de mais ou menos explícito e HH:MM preenchido com zeros. Ela não indica que o resultado identifica uma zona geográfica.

Separe fusos fixos de zonas nomeadas

Um fuso UTC numérico não equivale a uma zona nomeada, como Europe/London ou America/New_York. Zonas nomeadas incluem regras históricas e futuras, e seu fuso ativo pode mudar conforme o horário de verão ou a legislação. Este formatador não faz essa consulta: ele apenas representa o número exato fornecido por você. Use-o quando um fuso fixo já for o dado correto, ao normalizar um valor calculado em outro lugar ou ao criar dados de teste determinísticos que não possam mudar com novas versões dos bancos de fusos. Não o use para descobrir a hora local de uma pessoa, decidir qual fuso vale para uma cidade em determinada data nem converter uma zona nomeada em valor sazonal. Não existem requisição de rede, valor aleatório, leitura do relógio, dependência regional, inspeção do ambiente ou padrão oculto. Por isso, o resultado é reproduzível na API e no navegador. Cada solicitação de API custa US$ 0,002. Entradas inválidas retornam um erro tipado com explicação objetiva, permitindo que você corrija o campo em vez de aceitar uma suposição. Para uso posterior confiável, mantenha offset_minutes como fonte numérica e offset como apresentação normalizada.