Thursday, January 29, 2026
HomeLanguagesJavascriptJavaScript Intl.NumberFormat() Constructor

JavaScript Intl.NumberFormat() Constructor

The Javascript Intl.NumberFormat() constructor is used to create Intl.NumberFormat() object that enables language-sensitive number formatting. This constructor is created with or without a new keyword both create a new Intl.NumberFormat instance.

Syntax:

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

Parameters:

  • Locales: It contains a String or an array of Strings that allow the following value.
    • num: It specifies the numbering system to be used which can be arab, bali, latn, tibt etc.
  • Options: It is an object which can have properties like compactDisplay, currency,currencyDisplay, currencySign ,style, unit,unitDisplay, etc.

Return value: It return a new Intl.NumberFormat object.

Example 1: In this example, we will use the basic use of Intl.NumberFormat() constructor.

Javascript




let amount = 10000;
let newAmount = new Intl.NumberFormat().format(amount)
  
console.log(newAmount);


Output:

10,000

Example 2: In this example, we will perform Decimal and percentage formatting with the help of Intl.NumberFormat() constructor.

Javascript




let amount = 2000;
  
let newAmount1 = new Intl.NumberFormat('en-US',
    { style: 'decimal' }).format(amount);
      
let newAmount2 = new Intl.NumberFormat('en-US',
    { style: 'percent' }).format(amount);
      
console.log(newAmount1);
console.log(newAmount2);


Output:

2,000
200,000%

Example 3: In this example, we will perform unit formatting and currency formatting with the help of Intl.NumberFormat() constructor.

Javascript




let num = 5000;
  
// Unit formatting
let num1 = new Intl.NumberFormat('en-US',
    { style: 'unit', unit: 'liter' }).format(num);
let num2 = new Intl.NumberFormat('en-US',
    { 
        style: 'unit',
        unit: 'liter', 
        unitDisplay: 'long' 
    }).format(num);
  
// Currancy formatting
let currancy = 50;
let newCurrancy = new Intl.NumberFormat('en-US',
    { 
        style: 'currency', 
        currency: 'USD' 
    }).format(currancy);
  
console.log(num1);
console.log(num2);
console.log(newCurrancy);


Output:

5,000 L
5,000 liters
$50.00

Supported Browsers:

  • Chrome 24
  • Edge 12
  • Firefox 29
  • Opera 15
  • Safari 10

We have a complete list of JavaScript Intl methods to check please go through, the JavaScript Intl Reference article.

RELATED ARTICLES

1 COMMENT

Most Popular

Dominic
32477 POSTS0 COMMENTS
Milvus
122 POSTS0 COMMENTS
Nango Kala
6849 POSTS0 COMMENTS
Nicole Veronica
11978 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12065 POSTS0 COMMENTS
Shaida Kate Naidoo
6986 POSTS0 COMMENTS
Ted Musemwa
7221 POSTS0 COMMENTS
Thapelo Manthata
6934 POSTS0 COMMENTS
Umr Jansen
6916 POSTS0 COMMENTS