Intl.NumberFormat (ES2020)
A polyfill for ES2020 Intl.NumberFormat and Number.prototype.toLocaleString.
Installation
- npm
- yarn
npm i @formatjs/intl-numberformat
Requirements
This package requires the following capabilities:
If you're supporting IE11-, this requires
Intl.getCanonicalLocales.
Features
Everything in the ES2020 Internationalization API spec (https://tc39.es/ecma402).
Usage
Simple
import '@formatjs/intl-numberformat/polyfill'
import '@formatjs/intl-numberformat/locale-data/en' // locale-data for en
Dynamic import + capability detection
import {shouldPolyfill} from '@formatjs/intl-numberformat/should-polyfill'
async function polyfill(locale: string) {
if (shouldPolyfill()) {
// Load the polyfill 1st BEFORE loading data
await import('@formatjs/intl-numberformat/polyfill')
}
if (Intl.NumberFormat.polyfilled) {
switch (locale) {
default:
await import('@formatjs/intl-numberformat/locale-data/en')
break
case 'fr':
await import('@formatjs/intl-numberformat/locale-data/fr')
break
}
}
}
Supported Units
Simple Units
Currently the spec defines a list of sanctioned units as below.
type Unit =
| 'acre'
| 'bit'
| 'byte'
| 'celsius'
| 'centimeter'
| 'day'
| 'degree'
| 'fahrenheit'
| 'fluid-ounce'
| 'foot'
| 'gallon'
| 'gigabit'
| 'gigabyte'
| 'gram'
| 'hectare'
| 'hour'
| 'inch'
| 'kilobit'
| 'kilobyte'
| 'kilogram'
| 'kilometer'
| 'liter'
| 'megabit'
| 'megabyte'
| 'meter'
| 'mile'
| 'mile-scandinavian'
| 'millimeter'
| 'milliliter'
| 'millisecond'
| 'minute'
| 'month'
| 'ounce'
| 'percent'
| 'petabyte'
| 'pound'
| 'second'
| 'stone'
| 'terabit'
| 'terabyte'
| 'week'
| 'yard'
| 'year'
Compound Units
You can specify X-per-Y unit, where X and Y are sactioned simple units (e.g. kilometer-per-hour).
The library will choose the best-fit localized pattern to format this compound unit.