Common Locale Data Repository Pluralization Logic

npm install cldr-plurals
6 downloads in the last week
22 downloads in the last month


CLDR.js provides logic from the Unicode Common Locale Data Repository. Currently, the only functionality it provides is the pluralization rules.

Plural Rules


CLDR.pluralForm(0, 'en');     // => 'other'
CLDR.pluralForm(1, 'en-US');  // => 'one'
CLDR.pluralForm(2.383, 'fr'); // => 'other'
CLDR.pluralForm(1, 'zh');     // => 'other'
CLDR.pluralForm(26, 'uk');    // => 'many'

If you set CLDR.defaultLanguage then the second argument is optional:

CLDR.defaultLanguage = 'pl';
CLDR.pluralForm(22); // => 'few'

Though CLDR.js doens't provide an I18n framework, you can use this logic as part of yours. For example, you might write the following:

CLDR.defaultLanguage = 'en';

var translations = {
  'en': {
    'widget': {
      'one': 'one widget',
      'other': '{{count}} widgets'
  'jp': {
    'widget': {
      'other': '{{count}} ウィジェット'

function pluralize(key, count, language) {
  var form = CLDR.pluralForm(count),
      language = language || CLDR.defaultLanguage;
  return translations[language][key][form];
npm loves you