CKTIS / JavaScript
Intl.NumberFormat — formatação de números segundo as definições linguísticas e regionais
`Intl.NumberFormat` converte números em texto de acordo com uma configuração linguística e regional (*locale*) e com as opções de formatação. Permite controlar, entre outros aspetos, o agrupamento de algarismos e as casas decimais; `format` devolve uma função associada a um formatador específico.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const formatter = new Intl.NumberFormat(locales, options);
formatter.format(value);Intl.NumberFormat cria um formatador de números com base nas configurações linguísticas e regionais (locales) indicadas em locales e nas opções de options. Faz parte da norma ECMA-402, não da API DOM. A formatação produz texto para apresentação, não um novo valor numérico nem um analisador de números localizados.
Intl.NumberFormat.prototype.format é uma propriedade acessora: ao lê-la numa instância, obtém-se uma função associada a essa instância. Assim, const format = formatter.format permite chamar mais tarde format(value) sem perder as definições. Pode reutilizar o mesmo formatador para vários valores.
minimumFractionDigits define o número mínimo e maximumFractionDigits o número máximo de algarismos após o separador decimal. Quando estes limites se aplicam, defini-los ambos como 2 faz com que sejam apresentados dois algarismos após o separador decimal com a definição predefinida trailingZeroDisplay: "auto", com arredondamento se necessário. Com trailingZeroDisplay: "stripIfInteger", os zeros após o separador decimal são omitidos se o resultado arredondado for um número inteiro. Com a definição predefinida roundingPriority: "auto", se indicar maximumSignificantDigits, o formatador ignora ambos os limites de casas decimais. useGrouping: false desativa o agrupamento. O estilo currency exige uma opção currency, mas não converte taxas de câmbio.
O exemplo seleciona explicitamente en-US e os algarismos latn. As configurações linguísticas e regionais disponíveis e os detalhes da formatação podem depender da implementação e dos dados linguísticos e regionais que esta utiliza. Verifique o resultado no navegador de destino; a disponibilidade no Node 24 não comprova o suporte nos navegadores.
Exemplos
const formatter = new Intl.NumberFormat("en-US", {
numberingSystem: "latn",
useGrouping: false,
minimumFractionDigits: 2,
maximumFractionDigits: 2
});
const format = formatter.format;
console.log(format(1234.5));Resultado
1234.50
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.