Intl.PluralRules

Sprachen verwenden unterschiedliche Muster, um sowohl die Mehrzahl von Gegenständen (Kardinalzahlen) als auch die Reihenfolge von Gegenständen (Ordinalzahlen) auszudrücken. Englisch hat zwei Formen zur Ausdruck von Kardinalzahlen: eine für die Einzahl "item" (1 hour, 1 dog, 1 fish) und eine andere für Null oder jede andere Anzahl von "items" (0 hours, 2 lemmings, 100000.5 fish), während Chinesisch nur eine Form hat und Arabisch sechs! Ähnlich hat Englisch vier Formen für die Ausdruck von Ordinalzahlen: "th", "st", "nd", "rd", die die Sequenz: 0th, 1st, 2nd, 3rd, 4th, 5th, ..., 21st, 22nd, 23rd, 24th, 25th und so weiter ergeben, während sowohl Chinesisch als auch Arabisch nur eine Form für Ordinalzahlen haben.

Für eine bestimmte Sprache und eine Reihe von Formatierungsoptionen geben die Methoden Intl.PluralRules.prototype.select() und Intl.PluralRules.prototype.selectRange() ein Tag zurück, das die Pluralform einer einzelnen Zahl oder eines Zahlenbereichs repräsentiert, sei es kardinal oder ordinal. Code kann die zurückgegebenen Tags verwenden, um Zahlen geeignet für die gegebene Sprache darzustellen. Die vollständige Menge der zurückgegebenen Tags kann sein: zero, one, two, few, many und other (die "allgemeine" Pluralform, auch verwendet, wenn die Sprache nur eine Form hat).

Da Englisch nur zwei Formen für Kardinalzahlen hat, gibt die select()-Methode nur zwei Tags zurück: "one" für den Singular und "other" für alle anderen Kardinalzahlen. Dies ermöglicht die Konstruktion von Sätzen, die in Englisch für jeden Fall Sinn ergeben, wie z.B.: "1 dog is happy; do you want to play with it?" und "10 dogs are happy; do you want to play with them?".

Die Erstellung geeigneter Sätze für jede Form hängt von der Sprache ab, und selbst im Englischen ist es möglicherweise nicht so einfach, wie ein "s" an ein Substantiv anzuhängen, um die Pluralform zu bilden. Anhand des obigen Beispiels sehen wir, dass die Form beeinflussen kann:

• Substantive: 1 dog, 2 dogs (aber nicht "fish" oder "sheep", die die gleiche Singular- und Pluralform haben).
• Verben: 1 dog is happy, 2 dogs are happy.
• Pronomen (und andere Bezüge): Do you want to play with it / them.

Andere Sprachen haben mehr Formen, und die Auswahl geeigneter Sätze kann noch komplexer sein.

select() kann in Englisch eines von vier Tags für Ordinalzahlen zurückgeben, die jede der zulässigen Formen repräsentieren: one für "st"-Nummern (1, 21, 31, ...), two für "nd"-Nummern (2, 22, 32, ...), few für "rd"-Nummern (3, 33, 43, ...) und other für "th"-Nummern (0, 4-20, etc.). Auch hier ermöglichen die zurückgegebenen Tags eine geeignete Formatierung von Strings, die eine Ordinalzahl beschreiben.

Weitere Informationen zu den Regeln und deren Verwendung finden Sie unter Plural Rules. Für eine Liste der Regeln und ihrer Anwendung für verschiedene Sprachen siehe die LDML Language Plural Rules.

Intl.PluralRules()

Erstellt ein neues Intl.PluralRules-Objekt.

Intl.PluralRules.supportedLocalesOf()

Gibt ein Array zurück, das diejenigen der angegebenen Locales enthält, die unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.

Diese Eigenschaften sind auf Intl.PluralRules.prototype definiert und werden von allen Intl.PluralRules-Instanzen geteilt.

Intl.PluralRules.prototype.constructor

Die Konstruktionsfunktion, die das Instanzobjekt erstellt hat. Für Intl.PluralRules-Instanzen ist der anfängliche Wert der Intl.PluralRules-Konstruktor.

Intl.PluralRules.prototype[Symbol.toStringTag]

Der anfängliche Wert der [Symbol.toStringTag]-Eigenschaft ist der String "Intl.PluralRules". Diese Eigenschaft wird in Object.prototype.toString() verwendet.

Intl.PluralRules.prototype.resolvedOptions()

Gibt ein neues Objekt mit Eigenschaften zurück, die die während der Initialisierung des Objekts berechneten Locale- und Kollationsoptionen widerspiegeln.

Intl.PluralRules.prototype.select()

Gibt einen String zurück, der angibt, welche Pluralregel für Lokalisierungs-gerechtes Formatieren verwendet werden soll.

Intl.PluralRules.prototype.selectRange()

Diese Methode erhält zwei Werte und gibt einen String zurück, der angibt, welche Pluralregel für Lokalisierungs-gerechtes Formatieren verwendet werden soll.

Dieses Beispiel zeigt einige der Variationen in lokalisierten Pluralregeln für Kardinalzahlen.

Um das Format für die Sprache zu erhalten, die in der Benutzeroberfläche Ihrer Anwendung verwendet wird, geben Sie sicher diese Sprache (und möglicherweise einige Fallback-Sprachen) mithilfe des Konstruktor-locales-Arguments an:

// US English
const enCardinalRules = new Intl.PluralRules("en-US");
console.log(enCardinalRules.select(0)); // "other"
console.log(enCardinalRules.select(1)); // "one"
console.log(enCardinalRules.select(2)); // "other"
console.log(enCardinalRules.select(3)); // "other"

// Arabic
const arCardinalRules = new Intl.PluralRules("ar-EG");
console.log(arCardinalRules.select(0)); // "zero"
console.log(arCardinalRules.select(1)); // "one"
console.log(arCardinalRules.select(2)); // "two"
console.log(arCardinalRules.select(6)); // "few"
console.log(arCardinalRules.select(18)); // "many"

Die Pluralform der angegebenen Zahl kann auch von Konstruktor-options abhängen, wie z.B. wie die Zahl gerundet wird und ob sie kardinal oder ordinal ist.

Dieses Beispiel zeigt, wie Sie den Regeltyp auf "ordinal" setzen können und wie dies die Form für einige Zahlen in US-Englisch beeinflusst.

// US English - ordinal
const enOrdinalRules = new Intl.PluralRules("en-US", { type: "ordinal" });
console.log(enOrdinalRules.select(0)); // "other" (0th)
console.log(enOrdinalRules.select(1)); // "one"   (1st)
console.log(enOrdinalRules.select(2)); // "two"   (2nd)
console.log(enOrdinalRules.select(3)); // "few"   (3rd)
console.log(enOrdinalRules.select(4)); // "other" (4th)
console.log(enOrdinalRules.select(21)); // "one"  (21st)

Der Code unten erweitert das vorherige Beispiel und zeigt, wie das zurückgegebene Tag für eine Ordinalzahl verwendet werden kann, um Text in Englisch zu formatieren.

const enOrdinalRules = new Intl.PluralRules("en-US", { type: "ordinal" });

const suffixes = new Map([
  ["one", "st"],
  ["two", "nd"],
  ["few", "rd"],
  ["other", "th"],
]);
const formatOrdinals = (n) => {
  const rule = enOrdinalRules.select(n);
  const suffix = suffixes.get(rule);
  return `${n}${suffix}`;
};

formatOrdinals(0); // '0th'
formatOrdinals(1); // '1st'
formatOrdinals(2); // '2nd'
formatOrdinals(3); // '3rd'
formatOrdinals(4); // '4th'
formatOrdinals(11); // '11th'
formatOrdinals(21); // '21st'
formatOrdinals(42); // '42nd'
formatOrdinals(103); // '103rd'

• Polyfill von Intl.PluralRules in FormatJS
• Intl