CKTIS / JavaScript
Intl.PluralRules.prototype.select(): výběr kategorie množného čísla
`select(value)` vrací gramatickou kategorii jedné hodnoty podle jazykového nastavení a voleb instance. Výsledek slouží k výběru přeloženého textu, nikoli k formátování čísla.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
rules.select(value)Intl.PluralRules.prototype.select je metoda instance. Vytvořte rules pomocí new Intl.PluralRules(locales, options) a zavolejte rules.select(value). Metoda vrací jeden z řetězců "zero", "one", "two", "few", "many" nebo "other". Dostupné kategorie závisí na skutečně použitém jazykovém nastavení a typu pravidel; "one" není univerzálním testem value === 1. Kategorii použijte jako klíč k přeložené variantě textu: metoda text nepřekládá ani neformátuje číslo.
Výchozí typ "cardinal" platí pro základní číslovky („kolik?“), typ "ordinal" pro řadové číslovky („kolikátý?“). Zaokrouhlení a volby jako minimumFractionDigits mohou kategorii změnit, protože pravidla mohou záviset na viditelných desetinných místech. select třídí jedinou hodnotu; selectRange třídí celý rozsah. Skutečně použité jazykové nastavení zjistíte z rules.resolvedOptions().locale; může se lišit od požadovaného.
Hodnotou this musí být inicializovaná instance Intl.PluralRules. Volání na samotném prototypu nebo jako samostatná funkce bez vazby na instanci vyvolá TypeError. Jak ve vydání ECMA-402 z roku 2024, tak v aktuálním návrhu používá metoda select operaci ToNumber: číselné řetězce se převádějí na hodnoty typu Number ("2" se převede na 2), zatímco BigInt a Symbol vyvolají TypeError. Vynechaný argument se převede na NaN; NaN i obě nekonečna vracejí "other". Vrácená kategorie proto nepotvrzuje platnost vstupu.
Příklady
{
const cardinal = new Intl.PluralRules('en-US');
const ordinal = new Intl.PluralRules('en-US', { type: 'ordinal' });
const withFraction = new Intl.PluralRules('en-US', { minimumFractionDigits: 1 });
console.log(cardinal.select(1));
console.log(cardinal.select(2));
console.log(ordinal.select(2));
console.log(withFraction.select(1));
}Výsledek
one other two other
Podle pravidel americké angličtiny dává `2` jako základní číslovka `other`, jako řadová `two`. Při vynucení jednoho desetinného místa se `1` posoudí jako `1.0`, takže vrátí `other` místo `one`.
Související lekce
- JavaScript · Lekce 24 · Pokročilá · Verze: 4
Zdroje
- ECMAScript® 2024 Internationalization API Specification — Intl.PluralRules.prototype.select
- ECMAScript® 2024 Internationalization API Specification — ResolvePlural
- ECMAScript® 2024 Language Specification — ToNumber
- ECMA-402 living draft — Intl.PluralRules.prototype.select
- MDN — Intl.PluralRules.prototype.select()
- MDN — Intl.PluralRules() constructor