CKTIS / JavaScript
Intl.PluralRules.prototype.select(): výber kategórie množného čísla
`select(value)` vráti gramatickú kategóriu jednej hodnoty podľa jazykového nastavenia a volieb inštancie. Výsledok slúži na výber preloženého textu, nie na formátovanie čísla.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rules.select(value)Intl.PluralRules.prototype.select je metóda inštancie. Vytvorte rules pomocou new Intl.PluralRules(locales, options) a zavolajte rules.select(value). Metóda vracia jeden z reťazcov "zero", "one", "two", "few", "many" alebo "other". Dostupné kategórie závisia od skutočne použitého jazykového nastavenia a typu pravidiel; "one" nie je všeobecným testom value === 1. Kategóriu použite ako kľúč k preloženému variantu textu: metóda text neprekladá ani neformátuje číslo.
Predvolený typ "cardinal" platí pre základné číslovky („koľko?“), typ "ordinal" pre radové číslovky („koľký v poradí?“). Zaokrúhľovanie a voľby ako minimumFractionDigits môžu zmeniť kategóriu, pretože pravidlá môžu závisieť od viditeľných desatinných miest. select triedi jednu hodnotu; selectRange triedi celý rozsah. Skutočne použité jazykové nastavenie zistíte z rules.resolvedOptions().locale; môže sa líšiť od požadovaného.
Hodnotou this musí byť inicializovaná inštancia Intl.PluralRules. Volanie na samotnom prototype alebo ako samostatná funkcia bez väzby na inštanciu vyvolá TypeError. Vo vydaní ECMA-402 z roku 2024 aj v aktuálnom návrhu používa metóda select operáciu ToNumber: číselné reťazce sa prevádzajú na hodnoty typu Number ("2" sa zmení na 2), zatiaľ čo BigInt a Symbol vyvolajú TypeError. Vynechaný argument sa zmení na NaN; NaN aj obe nekonečná vracajú "other". Vrátená kategória preto nepotvrdzuje platnosť vstupu.
Prí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ýsledok
one other two other
Podľa pravidiel americkej angličtiny dáva `2` ako základná číslovka `other`, ako radová `two`. Pri vynútení jedného desatinného miesta sa `1` posúdi ako `1.0`, takže vráti `other` namiesto `one`.
Súvisiace lekcie
- JavaScript · Lekcia 24 · Pokročilá · Verzia: 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