JavaScript Intl.PluralRules: выбрать форму слова

Категория: JavaScript · Язык: JavaScript · Обновлено:

Intl.PluralRules определяет категорию числа для языка: one, few, many, other и другие. Он не форматирует число, а говорит, какую форму слова выбрать. Это удобно для «1 день», «2 дня», «5 дней» без самодельных условий и таблиц для каждой локали.

Получить категории для русского

JavaScript
const ru = new Intl.PluralRules("ru-RU");

console.log(ru.select(1));   // one
console.log(ru.select(2));   // few
console.log(ru.select(5));   // many
console.log(ru.select(21));  // one

Русская локаль различает one, few, many и other (для дробных значений). Категория зависит от последних цифр числа, а не только от величины: 21 снова one, 22 — few, 25 — many. Английская локаль проще: one для 1 и other для остальных.

Подставить слово в шаблон

JavaScript
const ru = new Intl.PluralRules("ru-RU");
const forms = {one: "день", few: "дня", many: "дней", other: "дня"};

function days(count) {
    return `${count} ${forms[ru.select(count)] ?? forms.other}`;
}

console.log(days(1));  // 1 день
console.log(days(2));  // 2 дня
console.log(days(5));  // 5 дней

Словарь должен покрывать все категории, которые возвращает локаль. Для дробей и нестандартных чисел используйте other как безопасный fallback. Intl.PluralRules не выбирает падеж для прилагательных и не склоняет глаголы — для сложных фраз нужен ICU MessageFormat или библиотека.

Для порядковых числительных есть type: "ordinal": select(1) вернёт one для «1st», select(2) — two для «2nd» в английском. Русские порядковые формы так не покрываются полностью, проверяйте на своих данных. Метод selectRange() поддерживается в новых движках и помогает для «1–2 дня», но требует проверки совместимости.

Метод поддерживается в Chrome 63+, Firefox 58+, Safari 13+ и Node.js 10+. Локаль задавайте явно, чтобы серверный и клиентский рендер совпадали. Не создавайте PluralRules на каждый вызов в цикле — вынесите его в модуль.

Документация: Intl.PluralRules, CLDR plural rules.