# Intl.NumberFormat

## Syntax

```javascript
new Intl.NumberFormat([locales[, options]])
Intl.NumberFormat.call(this[, locales[, options]])
```

### Parameters

…

<dl>
  <dt>options</dt>
  <dd>
    <p>Optional. An object with some or all of the following properties:</p>
    <dl>
      …
      <dt>abbreviationThreshold</dt>
      <dd>Numbers whose absolute value is greater than this number will be abbreviated. Possible values are from <code>0</code> to <code>Infinity</code>; the default is <code>Infinity</code>, which effectively disables abbreviation.</dd>
      
      <dt>abbreviationRoundingMethod</dt>
      <dd>The rounding behavior to exhibit when abbreviating a number. Possible values are <code>Intl.NumberFormat.ROUND_CEILING</code>, <code>Intl.NumberFormat.ROUND_FLOOR</code>, <code>Intl.NumberFormat.ROUND_UP</code>, <code>Intl.NumberFormat.ROUND_DOWN</code>, <code>Intl.NumberFormat.ROUND_HALF_DOWN</code>, <code>Intl.NumberFormat.ROUND_HALF_EVEN</code>, and <code>Intl.NumberFormat.ROUND_HALF_UP</code>; the default is <code>Intl.NumberFormat.ROUND_HALF_CEILING</code>. For more information about rounding modes, see <a href="#roundingmodes">rounding modes</a>.</dd>
      …
    </dl>
  </dd>
</dl>

…

## Examples

…

### Example: Using `options`

The results can be customized using the options argument:

```javascript
var number = 1234567.89;
…

// abbreviate a number
console.log(new Intl.NumberFormat('en-US', { abbreviationThreshold: 1e6, maximumSignificantDigits: 3 }).format(number));
// → 1.23M
console.log(new Intl.NumberFormat('en-US', { abbreviationThreshold: 1e6, style: 'currency', maximumSignificantDigits: 3 }).format(number));
// → $1.23M
console.log(new Intl.NumberFormat('ja-JP', { abbreviationThreshold: 1e6, maximumSignificantDigits: 3 }).format(number));
// → 123万
…
```

## Addendum

<a name="roundingmodes"></a>
### Rounding modes
<dl>
  <dt>Intl.NumberFormat.ROUND_CEILING</dt>
  <dd>Rounding mode to round towards positive infinity.</dd>
  
  <dt>Intl.NumberFormat.ROUND_FLOOR</dt>
  <dd>Rounding mode to round towards negative infinity.</dd>
  
  <dt>Intl.NumberFormat.ROUND_DOWN</dt>
  <dd>Rounding mode to round towards zero.</dd>
  
  <dt>Intl.NumberFormat.ROUND_UP</dt>
  <dd>Rounding mode to round away from zero.</dd>
  
  <dt>Intl.NumberFormat.ROUND_HALF_CEILING</dt>
  <dd>Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round towards positive infinity.</dd>
  
  <dt>Intl.NumberFormat.ROUND_HALF_UP</dt>
  <dd>Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round up.</dd>

  <dt>Intl.NumberFormat.ROUND_HALF_EVEN</dt>
  <dd>Rounding mode to round towards the "nearest neighbor" unless both neighbors are equidistant, in which case, round towards the even neighbor.</dd>
  
  <dt>Intl.NumberFormat.ROUND_HALF_FLOOR</dt>
  <dd>Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round towards negative infinity.</dd>
  
  <dt>Intl.NumberFormat.ROUND_HALF_DOWN</dt>
  <dd>Rounding mode to round towards "nearest neighbor" unless both neighbors are equidistant, in which case round down.</dd>
</dl>