在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Intl.NumberFormat() constructor creates objects that enable language sensitive number formatting.

句法

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

参数

locales 可选

A string with a BCP 47 language tag, or an array of such strings. For the general form and interpretation of the locales argument, see the Intl page . The following Unicode extension key is allowed:

nu

The numbering system to be used. Possible values include: " adlm ", " ahom ", " arab ", " arabext ", " bali ", " beng ", " bhks ", " brah ", " cakm ", " cham ", " deva ", " diak ", " fullwide ", " gong ", " gonm ", " gujr ", " guru ", " hanidec ", " hmng ", " hmnp ", " java ", " kali ", " khmr ", " knda ", " lana ", " lanatham ", " laoo ", " latn ", " lepc ", " limb ", " mathbold ", " mathdbl ", " mathmono ", " mathsanb ", " mathsans ", " mlym ", " modi ", " mong ", " mroo ", " mtei ", " mymr ", " mymrshan ", " mymrtlng ", " newa ", " nkoo ", " olck ", " orya ", " osma ", " rohg ", " saur ", " segment ", " shrd ", " sind ", " sinh ", " sora ", " sund ", " takr ", " talu ", " tamldec ", " telu ", " thai ", " tibt ", " tirh ", " vaii ", " wara ", " wcho ".

options 可选

An object with some or all of the following properties:

compactDisplay

Only used when notation is " compact ". Takes either " short " (default) or " long ".

currency

The currency to use in currency formatting. Possible values are the ISO 4217 currency codes, such as " USD " for the US dollar, " EUR " for the euro, or " CNY " for the Chinese RMB — see the Current currency & funds code list . There is no default value; if the style is " currency ", the currency property must be provided.

currencyDisplay

How to display the currency in currency formatting. Possible values are:

• " symbol " to use a localized currency symbol such as €, this is the default value,
• " narrowSymbol " to use a narrow format symbol ("$100" rather than "US$100"),
• " code " to use the ISO currency code,
• " name " to use a localized currency name such as " dollar ",

currencySign

In many locales, accounting format means to wrap the number with parentheses instead of appending a minus sign. You can enable this formatting by setting the currencySign option to " accounting ". The default value is " standard ".

localeMatcher

The locale matching algorithm to use. Possible values are " lookup " and " best fit "; the default is " best fit ". For information about this option, see the Intl page .

notation

The formatting that should be displayed for the number, the defaults is " standard "

• " standard " plain number formatting
• " scientific " return the order-of-magnitude for formatted number.
• " engineering " return the exponent of ten when divisible by three
• " compact " string representing exponent, defaults is using the "short" form.

numberingSystem

Numbering System. Possible values include: " arab ", " arabext ", " bali ", " beng ", " deva ", " fullwide ", " gujr ", " guru ", " hanidec ", " khmr ", " knda ", " laoo ", " latn ", " limb ", " mlym ", " mong ", " mymr ", " orya ", " tamldec ", " telu ", " thai ", " tibt ".

signDisplay

When to display the sign for the number; defaults to " auto "

• " auto " sign display for negative numbers only
• " never " never display sign
• " always " always display sign
• " exceptZero " sign display for positive and negative numbers, but not zero

style

The formatting style to use , the default is " decimal ".

• " decimal " for plain number formatting.
• " currency " for currency formatting.
• " percent " for percent formatting
• " unit " for unit formatting

unit

The unit to use in unit formatting, Possible values are core unit identifiers, defined in UTS #35, Part 2, Section 6 . A subset of units from the full list was selected for use in ECMAScript. Pairs of simple units can be concatenated with " -per- " to make a compound unit. There is no default value; if the style is " unit ", the unit property must be provided.

unitDisplay

The unit formatting style to use in unit formatting, the defaults is " short ".

• " long " (e.g., 16 litres )
• " short " (e.g., 16 l )
• " narrow " (e.g., 16l )

useGrouping

Whether to use grouping separators, such as thousands separators or thousand/lakh/crore separators. Possible values are true and false; the default is true.

let amount = 3500;
console.log(new Intl.NumberFormat().format(amount));
// → '3,500' if in US English locale
					

let amount = 3500;
new Intl.NumberFormat('en-US', {style: 'decimal'}).format(amount);
// → '3,500'
new Intl.NumberFormat('en-US', {style: 'percent'}).format(amount);
// → '350,000%'
					

let amount = 3500;
new Intl.NumberFormat('en-US', {style: 'unit', unit: 'liter'}).format(amount);
// → '3,500 L'
new Intl.NumberFormat('en-US', {style: 'unit', unit: 'liter', unitDisplay: 'long'}).format(amount);
// → '3,500 liters'
					

let amount = -3500;
new Intl.NumberFormat('en-US', {style: 'currency', currency: 'USD'}).format(amount);
// → '-$3,500.00'
new Intl.NumberFormat('bn', {
  style: 'currency',
  currency: 'USD',
  currencyDisplay: 'name'
}).format(amount);
// →  '-3,500.00 US dollars'
new Intl.NumberFormat('bn', {
  style: 'currency',
  currency: 'USD',
  currencySign: 'accounting'
}).format(amount);
// →  '($3,500.00)'
					

new Intl.NumberFormat('en-US', { notation: "scientific" }).format(987654321);
// → 9.877E8
new Intl.NumberFormat('pt-PT', { notation: "scientific" }).format(987654321);
// → 9,877E8
new Intl.NumberFormat('en-GB', { notation: "engineering" }).format(987654321);
// → 987.654E6
new Intl.NumberFormat('de', { notation: "engineering" }).format(987654321);
// → 987,654E6
new Intl.NumberFormat('zh-CN', { notation: "compact" }).format(987654321);
// → 9.9亿
new Intl.NumberFormat('fr', {
  notation: "compact",
  compactDisplay: "long"
}).format(987654321);
// → 988 millions
new Intl.NumberFormat('en-GB', {
  notation: "compact",
  compactDisplay: "short"
}).format(987654321);
// → 988M
					

new Intl.NumberFormat("en-US", {
    style: "percent",
    signDisplay: "exceptZero"
}).format(0.55);
// → '+55%'
					

new Intl.NumberFormat('bn', {
  style: 'currency',
  currency: 'USD',
  currencySign: 'accounting',
  signDisplay: 'always'
}).format(-3500);
// → '($3,500.00)'
					

另请参阅

• Intl

• 最后修改： Jul 14, 2020

相关话题

1. 标准内置对象
2. Intl
3. 方法
   1. Intl.getCanonicalLocales()
4. 相关页面：
5. Collator
6. DateTimeFormat
7. ListFormat
8. NumberFormat
9. PluralRules
10. RelativeTimeFormat
11. 继承：
12. Object
13. 特性
    1. Object.prototype.__proto__
    2. Object.prototype.constructor
14. 方法
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.valueOf()
    12. Object.setPrototypeOf()