O objetoIntl.NumberFormat é um construtor para objetos que habilita formatação de número sensível a linguagem.

Experimente

const number = 123456.789;console.log(  new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(    number,  ),);// Expected output: "123.456,79 €"// The Japanese yen doesn't use a minor unitconsole.log(  new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(    number,  ),);// Expected output: "￥123,457"// Limit to three significant digitsconsole.log(  new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(    number,  ),);// Expected output: "1,23,000"

Sintaxe

new Intl.NumberFormat([locales[, options]])Intl.NumberFormat.call(this[, locales[, options]])

Parâmetros

locales

Opcional. Uma string com uma tag de linguagem BCP 47 ou uma matriz delas. Para a forma geral e interpretação do argumentolocales, vejaIntl page. A seguinte chave extendida Unicode é permitida:

nu

O sistema de numeração que será usado. Os valores permitidos são:"arab","arabext","bali","beng","deva","fullwide","gujr","guru","hanidec","khmr","knda","laoo","latn","limb","mlym","mong","mymr","orya","tamldec","telu","thai","tibt".

options

Opcional. Um objeto com alguns ou todas as seguintes propriedades:

localeMatcher

O algoritmo de comparação de localização para utilizar. Os valores permitidos são"lookup" e"best fit"; o padrão é"best fit". Para mais informações sobre esta opção, vejaIntl page.

style

O estilo do formato a ser utilizado. Os valores permitidos são"decimal" para formato de número simples,"currency" para formato monetário e"percent" para formato percentual; o padrão é"decimal".

currency

A moeda para usar na formatação monetária. Os valores permitidos são os códigos de moedas da ISO 4217, como"USD" para dólar estadunidense,"EUR" para euro, ou"CNY" para RMB chinês — veja aLista de códigos de moedas e fundos atuais. Não há valor padrão; se ostyle for"currency", a propriedadecurrency deverá ser informada.

currencyDisplay

Como será mostrada a moeda na formatação monetária. Os valores permitidos são"symbol" para usar um símbolo de moeda localizado como €,"code" para usar o código de moeda ISO,"name" para usar o nome da moeda localizado como"dollar"; o padrão é"symbol".

useGrouping

Se usar separadores de agrupamento, como separadores de milhares ou milhares/cem mil/dez milhões. Os valores permitidos sãotrue efalse; o padrão étrue.

As próximas propriedades se dividem em dois grupos:minimumIntegerDigits,minimumFractionDigits, emaximumFractionDigits no primeiro grupo,minimumSignificantDigits andmaximumSignificantDigits em outro. Se pelo menos uma propriedade do segundo grupo for informado, então o primeiro grupo é ignorado.

minimumIntegerDigits

A quantidade mínima de dígitos inteiros para utilizar. É possível usar valores de 1 a 21; o padrão é 1.

minimumFractionDigits

A quantidade mínima de dígitos fracionados para utilizar. É possível usar valores de 0 a 20; o padrão para formatos de números simples e percentuais é 0; o padrão para formatos monetários é a menor unidade de dígitos fornecidos pelalista de códigos de moedas ISO 4217 (2 se a lista não fornecer a informação).

maximumFractionDigits

O número máximo de dígitos fracionados para utilizar. É possível usar valores de 0 a 20; o padrão para a formatação de número simples é o maior entreminimumFractionDigits e 3; o padrão para formatos monetários é o maior número de dígitos entreminimumFractionDigits e o fornecido pelalista de códigos de moedas ISO 4217 (2 se a lista não fornecer a informação); o padrão para a formatação percentual é o maior número entreminimumFractionDigits e 0.

minimumSignificantDigits

A quantidade mínima de dígitos significantes para usar. Os valores permitidos são de 1 a 21; o padrão é 1.

maximumSignificantDigits

A quantidade máxima de dígitos significantes para usar. Os valores permitidos são de 1 a 21; o padrão éminimumSignificantDigits.

Descrição

Propriedades

Intl.NumberFormat.prototype

Pertime a inclusão de propriedades a todos os objetos.

Métodos

Intl.NumberFormat.supportedLocalesOf()

Retorna uma matriz contendo as localizações fornecidas que são suportadas sem retornar a localização padrão em tempo de execução.

InstânciasNumberFormat

Propriedades

As instâncias deNumberFormat herdam as seguntes propriedades de seu protótipo:

Methods

As instâncias deNumberFormat herdam os seguintes métodos de seu protótipo:

Exemplos

Uso básico

No uso básico sem a especificação de uma localização, o método retornará uma string formatada com a localização e as opções padrão.

var numero = 3500;console.log(new Intl.NumberFormat().format(numero));// → '3,500' se a localização for U.S. English

Usandolocales

Este exemplo mostra algumas variações de formatos de números localizados. A fim de obter o formato da linguagem utilizada na interface do usuário da sua aplicação, tenha certeza de especificar a língua (e possivelmente algumas línguas reservas) usando o argumentolocales:

var numero = 123456.789;// O alemão usa vírgula como separador de decimal e ponto para milharesconsole.log(new Intl.NumberFormat("de-DE").format(numero));// → 123.456,789// O árabe usa dígitos reais árabes em muitos países que falam árabeconsole.log(new Intl.NumberFormat("ar-EG").format(numero));// → ١٢٣٤٥٦٫٧٨٩// A Índia usa separadores de milhares/cem mil/dez milhõesconsole.log(new Intl.NumberFormat("en-IN").format(numero));// → 1,23,456.789// A chave de extensão nu requer um sistema de numeração, ex. decimal chinêsconsole.log(new Intl.NumberFormat("zh-Hans-CN-u-nu-hanidec").format(numero));// → 一二三,四五六.七八九// Quando informada uma língua sem suporte, como balinês,// inclua uma língua reseva, neste caso indonésioconsole.log(new Intl.NumberFormat(["ban", "id"]).format(numero));// → 123.456,789

Usandooptions

Os resultados podem ser personalizados usando o argumentooptions:

var numero = 123456.789;// informando um formato de moedaconsole.log(  new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(    numero,  ),);// → 123.456,79 €// o yen japonês não tem uma unidade menorconsole.log(  new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(    numero,  ),);// → ￥123,457// limitando a três dígitos significativosconsole.log(  new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(    numero,  ),);// → 1,23,000

Especificações

Compatibilidade com navegadores

Veja também