Formate um número de telefone internacional por país

Números de telefone são fáceis de armazenar como texto livre, mas difíceis de apresentar de maneira uniforme. Este formatador recebe um número e um código de país de duas letras, remove a pontuação comum, confere o código de chamada internacional quando informado e valida a quantidade exata de dígitos nacionais. Em seguida, devolve uma forma internacional legível e uma forma E.164 compacta. Comprimentos incorretos e códigos incompatíveis geram um erro claro, em vez de um resultado aparentemente válido, porém pouco confiável.

Informe o número e o país ao qual ele pertence

Digite o número de telefone no formato que você possui e selecione o código de país de duas letras. A entrada nacional pode conter separadores comuns, como espaços, parênteses, pontos ou hífens. Você também pode enviar um número internacional iniciado por sinal de mais ou usar o prefixo internacional 00.

Quando há um prefixo internacional, o formatador verifica se o código de chamada corresponde ao país selecionado. Essa conferência é importante porque a mesma sequência de dígitos nacionais pode parecer estruturalmente válida em mais de um lugar. Portanto, o país é uma instrução explícita, e não uma suposição feita com base nos dígitos.

Nos países que usam zero de tronco em chamadas nacionais, a entrada pode manter esse zero; ele é removido quando a notação internacional exige. O resultado inclui o código ISO normalizado, o código de chamada, o número nacional significativo, o valor E.164 compacto e uma versão espaçada para exibição. Assim, a resposta serve tanto para interfaces quanto para armazenamento normalizado e comparações posteriores.

Entenda o que a validação garante

Esta ferramenta faz uma validação estrutural para os países disponíveis no seletor. Ela confere os caracteres permitidos, a relação entre um código de chamada explícito e o país escolhido, além da quantidade esperada de dígitos nacionais. Uma divergência gera um erro que informa o país, a quantidade esperada e a recebida.

Esse comportamento é rigoroso de propósito: completar, cortar ou inventar dígitos silenciosamente poderia criar um número que não pertence a ninguém. A validade estrutural não prova que uma linha esteja atribuída, ativa ou acessível, que seja móvel nem que pertença a determinada pessoa. A ferramenta também não consulta uma operadora nem envia mensagem de verificação.

O formatador trabalha somente com o texto fornecido e uma tabela fixa de regras nacionais. Como não há consulta de rede, a mesma entrada sempre produz a mesma resposta, e o número não é compartilhado com serviços de diretório. Considere a saída uma representação confiável de uma estrutura compatível, não uma prova de que o assinante existe ou consentiu em receber contato.

Use corretamente as duas formas normalizadas

O campo formatado foi feito para exibição: começa com o código de chamada precedido pelo sinal de mais e separa os dígitos nacionais em grupos comuns para cada país. Armazene o código de país junto com o número normalizado quando seu aplicativo precisar preservar o contexto declarado pelo usuário. Se você recebe telefones em um formulário, valide-os antes de salvar, para que um erro na quantidade de dígitos possa ser corrigido enquanto a fonte ainda está disponível.

Em importações, mantenha a célula original em uma coluna de auditoria e grave o resultado normalizado em outro campo; isso impede que a limpeza apague evidências sobre a entrada. Trate sempre telefones como texto, nunca como números, para preservar zeros iniciais. Por fim, lembre-se de que formatação não significa permissão: aplique suas regras habituais de consentimento, privacidade e mensagens antes de ligar ou escrever para qualquer número retornado.