Intl.NumberFormat.prototype.format()

El método Intl.NumberFormat.prototype.format() formatea un número de acuerdo con la configuración regional y las opciones de formato de este objeto NumberFormat.

Syntax

numberFormat.format(number)

Parametros

number
A Number or BigInt to format.

Descripción

The format getter function formats a number into a string according to the locale and formatting options of this NumberFormat object.

Ejemplos

Usando format

Use the format getter function for formatting a single currency value, here for Russia:

var options = { style: 'currency', currency: 'RUB' };
var numberFormat = new Intl.NumberFormat('ru-RU', options);
console.log(numberFormat.format(654321.987));
// → "654 321,99 руб."

Usando format con map

Use the format getter function for formatting all numbers in an array. Note that the function is bound to the NumberFormat from which it was obtained, so it can be passed directly to Array.prototype.map.

var a = [123456.789, 987654.321, 456789.123];
var numberFormat = new Intl.NumberFormat('es-ES');
var formatted = a.map(numberFormat.format);
console.log(formatted.join('; '));
// → "123.456,789; 987.654,321; 456.789,123"

Especificaciones

Specification Status Comment
ECMAScript Internationalization API 1.0 (ECMA-402)
La definición de 'Intl.NumberFormat.prototype.format' en esta especificación.
Standard Initial definition.
ECMAScript Internationalization API 2.0 (ECMA-402)
La definición de 'Intl.NumberFormat.prototype.format' en esta especificación.
Standard
ECMAScript Internationalization API (ECMA-402)
La definición de 'Intl.NumberFormat.prototype.format' en esta especificación.
Living Standard

Browser compatibility

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome para AndroidFirefox para AndroidOpera para AndroidSafari en iOSSamsung InternetNode.js
formatChrome Soporte completo 24Edge Soporte completo 12
Notas
Soporte completo 12
Notas
Notas Before Edge 18, numbers are rounded to 15 decimal digits. For example, new Intl.NumberFormat('en-US').format(1000000000000005) returns "1,000,000,000,000,010".
Firefox Soporte completo 29IE Soporte completo 11
Notas
Soporte completo 11
Notas
Notas In Internet Explorer 11, numbers are rounded to 15 decimal digits. For example, new Intl.NumberFormat('en-US').format(1000000000000005) returns "1,000,000,000,000,010".
Opera Soporte completo 15Safari Soporte completo 10WebView Android Soporte completo 4.4Chrome Android Soporte completo 25Firefox Android Soporte completo 56Opera Android Soporte completo 14Safari iOS Soporte completo 10Samsung Internet Android Soporte completo 1.5nodejs Soporte completo 0.12
Notas
Soporte completo 0.12
Notas
Notas Before version 13.0.0, only the locale data for en-US is available by default. See the NumberFormat() constructor for more details.

Leyenda

Soporte completo  
Soporte completo
Ver notas de implementación.
Ver notas de implementación.

See also