Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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