format Property (Intl.NumberFormat)

Returns a function that formats a locale-specific number by using the specified number formatter settings.




Required. The name of the NumberFormat object to use as a formatter.


The function returned by the format property takes a single argument, value, and returns a string that represents the localized number by using the options specified in the NumberFormat object. If value is not provided, the function returns NaN (not a number).


The following example uses a NumberFormat object to create a localized number.

var nf = new Intl.NumberFormat(["en-US"], {  
    style: "currency",  
    currency: "CNY",  
    currencyDisplay: "symbol",  
    maximumFractionDigit: 1  

if (console && console.log) {  
    console.log(nf.format(100)); // "¥100.00"  


Supported in the Internet Explorer 11 standards document mode. Also supported in Store apps (Windows 8.1 and Windows Phone 8.1). See Version Information.
Not supported in the following document modes: Quirks, Internet Explorer 6 standards, Internet Explorer 7 standards, Internet Explorer 8 standards, Internet Explorer 9 standards, Internet Explorer 10 standards. Not supported in Windows 8.

See Also

Intl.NumberFormat Object