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 unit
console.log(
new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(
number,
),
);
// Expected output: "¥123,457"
// Limit to three significant digits
console.log(
new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(
number,
),
);
// Expected output: "1,23,000"
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Opcional. Uma string com uma tag de linguagem BCP 47 ou uma matriz delas. Para a forma geral e interpretação do argumento locales, veja Intl page. A seguinte chave extendida Unicode é permitida:
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, veja Intl page.
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".
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 a Lista de códigos de moedas e fundos atuais. Não há valor padrão; se o style for "currency", a propriedade currency deverá ser informada.
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".
Se usar separadores de agrupamento, como separadores de milhares ou milhares/cem mil/dez milhões. Os valores permitidos são true e false; o padrão é true.
As próximas propriedades se dividem em dois grupos: minimumIntegerDigits, minimumFractionDigits, e maximumFractionDigits no primeiro grupo, minimumSignificantDigits and maximumSignificantDigits em outro. Se pelo menos uma propriedade do segundo grupo for informado, então o primeiro grupo é ignorado.
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 pela lista de códigos de moedas ISO 4217 (2 se a lista não fornecer a informação).
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 entre minimumFractionDigits e 3; o padrão para formatos monetários é o maior número de dígitos entre minimumFractionDigits e o fornecido pela lista 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 entre minimumFractionDigits e 0.
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 argumento locales:
js
var numero =123456.789;// O alemão usa vírgula como separador de decimal e ponto para milhares
console.log(newIntl.NumberFormat("de-DE").format(numero));// → 123.456,789// O árabe usa dígitos reais árabes em muitos países que falam árabe
console.log(newIntl.NumberFormat("ar-EG").format(numero));// → ١٢٣٤٥٦٫٧٨٩// A Índia usa separadores de milhares/cem mil/dez milhões
console.log(newIntl.NumberFormat("en-IN").format(numero));// → 1,23,456.789// A chave de extensão nu requer um sistema de numeração, ex. decimal chinês
console.log(newIntl.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ésio
console.log(newIntl.NumberFormat(["ban","id"]).format(numero));// → 123.456,789
Os resultados podem ser personalizados usando o argumento options:
js
var numero =123456.789;// informando um formato de moeda
console.log(newIntl.NumberFormat("de-DE",{style:"currency",currency:"EUR"}).format(
numero,),);// → 123.456,79 €// o yen japonês não tem uma unidade menor
console.log(newIntl.NumberFormat("ja-JP",{style:"currency",currency:"JPY"}).format(
numero,),);// → ¥123,457// limitando a três dígitos significativos
console.log(newIntl.NumberFormat("en-IN",{maximumSignificantDigits:3}).format(
numero,),);// → 1,23,000
Tip: you can click/tap on a cell for more information.
Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.
Has more compatibility info.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.