WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Intl.PluralRules.prototype.select(): eine Pluralkategorie auswählen

`select(value)` ermittelt die grammatische Kategorie eines Werts anhand der Spracheinstellung und der Optionen der Instanz. Das Ergebnis dient zur Textauswahl, nicht zur Zahlenformatierung.

Version: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

rules.select(value)

Intl.PluralRules.prototype.select ist eine Instanzmethode. Erzeuge rules mit new Intl.PluralRules(locales, options) und rufe dann rules.select(value) auf. Die Methode liefert eine der Zeichenketten "zero", "one", "two", "few", "many" oder "other". Welche Kategorien vorkommen, hängt von der tatsächlich verwendeten Spracheinstellung und vom Regeltyp ab; "one" ist kein allgemeiner Test auf value === 1. Verwende die Kategorie als Schlüssel für übersetzte Textvarianten: Die Methode übersetzt keinen Text und formatiert keine Zahl.

Der Standardtyp "cardinal" gilt für Anzahlen („wie viele?“), "ordinal" für Rangfolgen („an welcher Stelle?“). Rundung und Ziffernoptionen wie minimumFractionDigits können die Kategorie ändern, da Regeln von sichtbaren Nachkommastellen abhängen können. select klassifiziert einen Wert, selectRange hingegen einen ganzen Bereich. rules.resolvedOptions().locale zeigt die tatsächlich verwendete Spracheinstellung, die von der angeforderten abweichen kann.

this muss eine initialisierte Intl.PluralRules-Instanz sein. Ein Aufruf direkt auf dem Prototyp oder als losgelöste, ungebundene Funktion löst TypeError aus. Sowohl in ECMA-402 (2024) als auch im fortlaufend aktualisierten Entwurf verwendet select die Operation ToNumber: Numerische Zeichenketten werden in Number-Werte umgewandelt (aus "2" wird 2), bei BigInt oder Symbol tritt TypeError auf. Ein fehlendes Argument wird zu NaN; NaN und beide Unendlichkeiten liefern "other". Die Rückgabe einer Kategorie ist daher keine Eingabevalidierung.

Beispiele

{
  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));
}

Ergebnis

one
other
two
other

Nach den Regeln des US-Englischen ergibt `2` als Kardinalzahl `other`, als Ordinalzahl dagegen `two`. Mit einer vorgeschriebenen Nachkommastelle wird `1` wie `1.0` eingestuft und liefert `other` statt `one`.

Zugehörige Lektionen

  • JavaScript · Lektion 24 · Fortgeschritten · Version: 4

Quellen