O que é numero pontilhado e por que ele continua existindo
O sistema de separador de milhar com pontos vem da tradição métrica portuguesa e brasileira. Em vez da vírgula para fracionar e do ponto para agrupar, usamos o inverso: ponto para milhares e vírgula para decimais. Isso significa que no Brasil escrevemos R$ 1.500,75 e não R$ 1,500.75.
Como funcionam as regras oficiais do numero pontilhado
A norma ABNT NBR 5891 e a Resolução do Banco Central definem que cada grupo de três dígitos deve ser separado por um ponto fino, sem espaços. Decimais usam vírgula. Não se aplica ponto único entre duas casas decimais — isso só existe em países anglo-saxões. Para valores acima de um milhão, a sequência se repete: 1.234.567,89. O erro mais comum que vejo é gente confundindo ponto decimal com separador de milhar quando lida com planilhas exportadas de sistemas americanos. Já perdi uma tarde inteira tentando debugar uma comparação de valores porque uma base tinha 1.000,00 e a outra 1,000.00. A solução foi padronizar tudo para Decimal do .NET antes de qualquer operação lógica, não confiar em string.
Pegadinhas que ninguém avisa
Primeiro: o ponto não é só estético. Ele altera o parsing. Funções como Convert.ToDecimal() do Crespeitam a cultura InvariantCulture, que usa vírgula como decimal. Se você chamar ToString() sem especificar a cultura, um número como 1500 vai virar 1.500 em português brasileiro, mas 1,500 em inglês — exatamente o mesmo valor visual, strings diferentes. Segundo: números muito grandes ficam ilegíveis com muitos pontos. Já vi sistemas financeiros exibindo 1.234.567.890.123,45 e ninguém conseguia ler de cara. Nesse caso, a prática recomendada pelo Bacen é manter o formato, mas usar negrito ou espaçamento visual no front-end para facilitar a leitura rápida.
Terceiro: exportação para CSV. Se você colocar um número formatado com ponto dentro de uma célula CSV sem escapar, sistemas de importação americanos vão tratar como vírgula decimal e o valor vira um décimo. Sempre exporte números brutos em CSV e formate na visualização.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Como formatar corretamente em diferentes contextos
No Excel, o código de formato personalizado é #.##0,00. Isso gera 1.234.567,89. Cuidado com a configuração regional da sua máquina — se o Windows estiver em inglês americano, o mesmo código vai produzir 1,234,567.89. Em Python, use locale.setlocale(locale.LC_NUMERIC, 'pt_BR.UTF-8') e depois locale.format_string('%f', valor, grouping=True). O resultado será 1.234.567,89. Se não tiver a locale pt_BR instalada no sistema, o formato volta para o padrão inglês e você perde o ponto.
Em JavaScript, Intl.NumberFormat com locale 'pt-BR' resolve: new Intl.NumberFormat('pt-BR', { minimumFractionDigits: 2 }).format(1234567.89) retorna "1.234.567,89". Isso é confiável em navegadores modernos, mas note que em ambientes Node.js antigos a performance pode cair em loops massivos de formatação.
Quando o numero pontilhado não deve ser usado
Em sistemas internacionais, APIs JSON e documentação técnica que cruzam fronteiras, o formato com vírgula decimal e separador de milhar por ponto gera ambiguidade constante. O padrão ISO 80000-1 recomenda o espaço como separador de milhar e a vírgula (ou ponto) como decimal, mas consistentemente. Para dados que vão trafegar entre países, evite ponto como separador de milhar e use notação científica ou strings com legenda clara. Também não use numero pontilhado em comandos de linha de comando ou inputs de usuário. Pessoas digitam pontos e vírgulas de formas inconsistentes. Aceite o valor bruto numérico e formate apenas na exibição.
Se precisar de uma referência rápida, a tabela abaixo resume os cenários mais comuns: Documentos fiscais brasileiros: obrigatório o formato com ponto. NF-e, Cupom Fiscal e DARF exigem 1.234,56.
Sistemas bancários: o Bacen padroniza ponto para milhar em extratos e contratos. Planilhas pessoais com uso misto BR/EUA: desative a formatação automática de números e trabale com valores brutos até a apresentação final.
