DasIntl.PluralRules-Objekt ermöglicht plural-sensitives Formatieren und pluralbezogene Sprachregeln.

Beschreibung

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 MethodenIntl.PluralRules.prototype.select() undIntl.PluralRules.prototype.selectRange() einTag 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 undother (die "allgemeine" Pluralform, auch verwendet, wenn die Sprache nur eine Form hat).

Da Englisch nur zwei Formen für Kardinalzahlen hat, gibt dieselect()-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 dogis happy, 2 dogsare happy.
• Pronomen (und andere Bezüge): Do you want to play withit /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, ...) undother 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 unterPlural Rules.Für eine Liste der Regeln und ihrer Anwendung für verschiedene Sprachen siehe dieLDML Language Plural Rules.

Konstruktor

Intl.PluralRules()

Erstellt ein neuesIntl.PluralRules-Objekt.

Statische Methoden

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.

Instanz-Eigenschaften

Diese Eigenschaften sind aufIntl.PluralRules.prototype definiert und werden von allenIntl.PluralRules-Instanzen geteilt.

Intl.PluralRules.prototype.constructor

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

Intl.PluralRules.prototype[Symbol.toStringTag]

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

Instanz-Methoden

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.

Beispiele

Verwendung von Locales

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 desKonstruktor-locales-Arguments an:

// US Englishconst 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"// Arabicconst 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"

Verwendung von Optionen

Die Pluralform der angegebenen Zahl kann auch vonKonstruktor-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 - ordinalconst 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)

Textformatierung mit dem zurückgegebenen Tag

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'

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonIntl.PluralRules in FormatJS
• Intl