@poppinss/intl-formatter
JavaScript Internationalization API, memoized for speed and performance

The @poppinss/intl-formatter
package ships with the memoized version of the Intl
API. Creating new instances of the new Intl.<AnyFormatter>
is painfully slow (see benchmarks), and this package caches those instances for re-use.
- The API is 100% identical to the official spec, instead of writing
new Intl.DateTimeFormat()
, you write formatters.date()
, and the rest is all the same. - All arguments are deeply compared during memoization.
Usage
Install the package from the npm registry as follows:
npm i @poppinss/intl-formatter
yarn add @poppinss/intl-formatter
And use it as follows:
import formatters from '@poppinss/intl-formatter'
const amount = formatters
.number('en-in', { style: 'currency', currency: 'INR' })
.format(10)
console.log(amount)
Available formatters
Why not use FormatJS?
FormatJS is a great and popular library for Internationalization. However, it has a large set of polyfills for different platforms (especially for browsers) that do not have complete support for Intl.
This package relies on the native Intl APIs available in Node.js runtime and caches the instances for re-use and performance.
Benchmarks
DateTimeFormat
DateTimeFormat@memoize x 2,192,264 ops/sec ±0.17% (99 runs sampled)
DateTimeFormat x 41,933 ops/sec ±16.93% (87 runs sampled)
Fastest is DateTimeFormat@memoize
NumberFormat
NumberFormat@memoize x 3,630,725 ops/sec ±0.87% (97 runs sampled)
NumberFormat x 88,994 ops/sec ±2.96% (93 runs sampled)
Fastest is NumberFormat@memoize
PluralRules
PluralRules@memoize x 3,296,162 ops/sec ±1.13% (98 runs sampled)
PluralRules x 80,256 ops/sec ±3.65% (82 runs sampled)
Fastest is PluralRules@memoize
RelativeTimeFormat
RelativeTimeFormat@memoize x 3,149,774 ops/sec ±1.07% (97 runs sampled)
RelativeTimeFormat x 114,421 ops/sec ±2.62% (90 runs sampled)
Fastest is RelativeTimeFormat@memoize
ListFormat
ListFormat@memoize x 1,875,493 ops/sec ±1.95% (95 runs sampled)
ListFormat x 311,985 ops/sec ±1.30% (96 runs sampled)
Fastest is ListFormat@memoize
DisplayNames
DisplayNames@memoize x 338,991 ops/sec ±0.96% (97 runs sampled)
DisplayNames x 128,909 ops/sec ±1.16% (94 runs sampled)
Fastest is DisplayNames@memoize