Intl.PluralRules

Sprachen verwenden unterschiedliche Muster, um sowohl die Anzahl der Gegenstände (Kardinalzahlen) als auch die Reihenfolge der Gegenstände (Ordinalzahlen) auszudrücken. Das Englische hat zwei Formen für die Darstellung von Kardinalzahlen: eine für das Singular "item" (1 hour, 1 dog, 1 fish) und eine andere für null oder eine andere Anzahl von "items" (0 hours, 2 lemmings, 100000.5 fish), während Chinesisch nur eine Form hat und Arabisch sechs! Ähnlich hat das Englische vier Formen zur Darstellung von Ordinalzahlen: "th", "st", "nd", "rd", was die Reihenfolge ergibt: 0th, 1st, 2nd, 3rd, 4th, 5th, ..., 21st, 22nd, 23rd, 24th, 25th und so weiter, während sowohl Chinesisch als auch Arabisch nur eine Form für Ordinalzahlen haben.

Unter Berücksichtigung einer bestimmten Sprache und einer Reihe von Formatierungsoptionen geben die Methoden Intl.PluralRules.prototype.select() und Intl.PluralRules.prototype.selectRange() ein Tag zurück, das die Pluralform einer einzelnen oder einer Zahlenreihe, kardinal oder ordinal, repräsentiert. Der Code kann die zurückgegebenen Tags verwenden, um Zahlen für die angegebene Sprache angemessen darzustellen. Die vollständige Menge der zurückgegebenen Tags könnte sein: zero, one, two, few, many und other (die "allgemeine" Pluralform, die auch verwendet wird, wenn die Sprache nur eine Form hat).

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

Das Erstellen angemessener Sätze für jede Form hängt von der Sprache ab und kann sogar in Englisch nicht so einfach sein wie einfach ein "s" an ein Substantiv anzuhängen, um die Pluralform zu bilden. Anhand des obigen Beispiels sehen wir, dass die Form Folgendes 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 Referenten): Do you want to play with it / them.

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

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

Für weitere Informationen über die Regeln und deren Verwendung siehe Plural Rules. Für eine Liste der Regeln und deren 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 bereitgestellten Locales enthält, die unterstützt werden, ohne dass auf die Standard-Locale der Laufzeitumgebung zurückgegriffen werden muss.

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

Intl.PluralRules.prototype.constructor

Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für Intl.PluralRules Instanzen ist der Anfangswert der Intl.PluralRules Konstruktor.

Intl.PluralRules.prototype[Symbol.toStringTag]

Der Anfangswert 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 die lokalisierungsbewusste Formatierung 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 die lokalisierungsbewusste Formatierung 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, stellen Sie sicher, dass Sie diese Sprache (und möglicherweise einige Ersatztoptionen) mit dem Konstruktor locales Argument angeben:

// 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 zum Beispiel davon, 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 sich dies auf die Form einiger Zahlen im US-Englischen auswirkt.

// 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 untenstehende Code erweitert das vorherige Beispiel und zeigt, wie Sie das zurückgegebene Tag für eine Ordinalzahl verwenden könnten, um Text auf 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