Intl.PluralRules

Sprachen verwenden unterschiedliche Muster, um sowohl die Anzahl von Gegenständen in der Mehrzahl (Kardinalzahlen) auszudrücken als auch die Reihenfolge von Gegenständen (Ordinalzahlen). Englisch hat zwei Formen, um Kardinalzahlen auszudrücken: eine für das Singular "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, um Ordinalzahlen auszudrücken: "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.

Für eine bestimmte Sprache und bestimmte 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, kardinal oder ordinal, darstellt. Code kann die zurückgegebenen Tags verwenden, um Zahlen für die gegebene Sprache angemessen darzustellen. Die vollständige Menge der Tags, die zurückgegeben werden könnte, sind: zero, one, two, few, many und other (die "allgemeine" Pluralform, die auch verwendet wird, 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 Singularfall und "other" für alle anderen Kardinalzahlen. Dies ermöglicht die Konstruktion von Sätzen, die im Englischen in jedem Fall sinnvoll sind, 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 kann selbst im Englischen komplizierter sein, als einfach nur ein "s" an ein Substantiv anzuhängen, um die Pluralform zu bilden. Anhand des obigen Beispiels können wir sehen, dass die Form beeinflussen kann:

• Substantive: 1 dog/2 dogs (aber nicht "fish" oder "sheep", die dieselbe Singular- und Pluralform haben).
• Verben: 1 dog is happy, 2 dogs are happy
• Pronomen (und andere Referenzen): Möchten Sie mit it / them spielen.

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

select() kann für Ordinalzahlen im Englischen eines von vier Tags zurückgeben, die jede der zulässigen Formen darstellen: 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, etc.). 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 auf 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 die bereitgestellten 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 Konstruktorfunktion, 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 die auf Locale bezogene 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 auf Locale bezogene Formatierung verwendet werden soll.

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

Um das Format für die in der Benutzeroberfläche Ihrer Anwendung verwendete Sprache zu erhalten, stellen Sie sicher, dass Sie diese Sprache (und möglicherweise einige Ersatzsprachen) 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 den Konstruktor options abhängen, z. B. 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 dies die Form für einige Zahlen im 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 untenstehende Code erweitert das vorherige Beispiel und zeigt, wie Sie das zurückgegebene Tag für eine Ordinalzahl verwenden könnten, um Text im Englischen 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