intl-pluralrules

What is intl-pluralrules?

The intl-pluralrules npm package is a polyfill for the ECMAScript Internationalization API's PluralRules object. It provides a way to get the plural form of a number for a given locale, which is useful for internationalizing applications.

What are intl-pluralrules's main functionalities?

Basic Usage

This feature allows you to create an instance of Intl.PluralRules for a specific locale and use it to determine the plural form of a number.

const IntlPluralRules = require('intl-pluralrules');
const pr = new IntlPluralRules('en-US');
console.log(pr.select(1)); // 'one'
console.log(pr.select(2)); // 'other'

Using Different Locales

This feature demonstrates how to use the package with different locales. In this example, the locale is set to French (fr-FR).

const IntlPluralRules = require('intl-pluralrules');
const prFrench = new IntlPluralRules('fr-FR');
console.log(prFrench.select(1)); // 'one'
console.log(prFrench.select(2)); // 'other'

Handling Multiple Plural Categories

This feature shows how the package can handle multiple plural categories, which is particularly useful for languages like Arabic that have more than two plural forms.

const IntlPluralRules = require('intl-pluralrules');
const prArabic = new IntlPluralRules('ar-EG');
console.log(prArabic.select(0)); // 'zero'
console.log(prArabic.select(1)); // 'one'
console.log(prArabic.select(2)); // 'two'
console.log(prArabic.select(3)); // 'few'
console.log(prArabic.select(11)); // 'many'
console.log(prArabic.select(100)); // 'other'

Other packages similar to intl-pluralrules

make-plural

The make-plural package provides similar functionality by generating pluralization functions for different locales. It is more customizable and can be used to generate plural rules for a wide range of languages.

cldrjs

The cldrjs package is a JavaScript library for using Unicode CLDR (Common Locale Data Repository) data. It provides comprehensive localization support, including pluralization rules, and is more extensive in scope compared to intl-pluralrules.

globalize

The globalize package is a library for internationalization and localization in JavaScript. It uses CLDR data and provides a wide range of features including number formatting, date and time formatting, and pluralization. It is more feature-rich compared to intl-pluralrules.

README

intl-pluralrules

A polyfill for Intl.PluralRules

Installation

npm install intl-pluralrules

Usage

To use the polyfill, just import it to make sure that Intl.PluralRules is available in your environment:

import 'intl-polyfill'

If Intl.PluralRules already exists, the polyfill will not be loaded. The implementation is itself available as intl-polyfill/plural-rules, if e.g. you'd prefer using it without polyfilling your Intl object.

This version mostly follows the published spec, with these difference:

• The prototype.select() input is not forced to number, so for locales like English the correct plural rule is returned for '1.0' input. On the other hand, the minimum/mamximum digits options are ignored.
• Only a "best-fit" locale matcher is supported.