Baseline Widely available *
O objeto Intl.NumberFormat
é um construtor para objetos que habilita formatação de número sensÃvel a linguagem.
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"
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 argumento locales
, veja Intl 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, veja Intl 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 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.
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ã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.
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 pela lista 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 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.
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
.
Intl.NumberFormat.prototype
Pertime a inclusão de propriedades a todos os objetos.
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.
NumberFormat
Propriedades
As instâncias de NumberFormat
herdam as seguntes propriedades de seu protótipo:
As instâncias de NumberFormat
herdam os seguintes métodos de seu protótipo:
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
Usando locales
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
:
var numero = 123456.789;
// O alemão usa vÃrgula como separador de decimal e ponto para milhares
console.log(new Intl.NumberFormat("de-DE").format(numero));
// â 123.456,789
// O árabe usa dÃgitos reais árabes em muitos paÃses que falam árabe
console.log(new Intl.NumberFormat("ar-EG").format(numero));
// â ١٢٣٤٥٦٫٧٨٩
// A Ãndia usa separadores de milhares/cem mil/dez milhões
console.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ês
console.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ésio
console.log(new Intl.NumberFormat(["ban", "id"]).format(numero));
// â 123.456,789
Usando options
Os resultados podem ser personalizados usando o argumento options
:
var numero = 123456.789;
// informando um formato de moeda
console.log(
new Intl.NumberFormat("de-DE", { style: "currency", currency: "EUR" }).format(
numero,
),
);
// â 123.456,79 â¬
// o yen japonês não tem uma unidade menor
console.log(
new Intl.NumberFormat("ja-JP", { style: "currency", currency: "JPY" }).format(
numero,
),
);
// â ï¿¥123,457
// limitando a três dÃgitos significativos
console.log(
new Intl.NumberFormat("en-IN", { maximumSignificantDigits: 3 }).format(
numero,
),
);
// â 1,23,000
Especificações Compatibilidade com navegadores Veja também
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4