Intl.PluralRules.prototype.selectRange()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit August 2023 browserübergreifend verfügbar.
Die Methode selectRange() von Intl.PluralRules-Instanzen nimmt zwei Werte entgegen und gibt einen String zurück, der angibt, welche Pluralregel für die gebietsschemaabhängige Formatierung des angegebenen Bereichs verwendet werden soll.
Syntax
selectRange(startRange, endRange)
Parameter
startRange-
Ein
Number,BigIntoder String, der den Anfang des Bereichs darstellt. Strings werden wie bei der Zahlenkonvertierung geparst. Allerdings verwendetselectRange()den exakten Wert, den der String darstellt, und vermeidet so einen Präzisionsverlust bei der impliziten Konvertierung in eine Zahl. endRange-
Ein
Number,BigIntoder String, der das Ende des Bereichs darstellt.
Rückgabewert
Ein String, der die Pluralkategorie des angegebenen Bereichs darstellt. Dies kann zero, one, two, few, many oder other sein, je nachdem, welche Kategorien für das Gebietsschema gemäß den LDML Language Plural Rules relevant sind.
Beschreibung
Diese Funktion wählt eine Pluralkategorie anhand des Gebietsschemas und der Formatierungsoptionen eines Intl.PluralRules-Objekts aus.
Das Verhalten entspricht konzeptionell der Bestimmung einer Pluralregel für eine einzelne Kardinal- oder Ordinalzahl. Sprachen haben eine oder mehrere Formen, um Bereiche zu beschreiben. Diese Methode gibt die Form zurück, die zum angegebenen Gebietsschema und zu den Formatierungsoptionen passt. Im Englischen gibt es für Bereiche nur eine Pluralform, etwa „1–10 apples“, und die Methode gibt other zurück. Andere Sprachen können viele Formen haben.
Beispiele
>selectRange() verwenden
new Intl.PluralRules("sl").selectRange(102, 201); // 'few'
new Intl.PluralRules("pt").selectRange(102, 102); // 'other'
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Internationalization API Specification> # sec-intl.pluralrules.prototype.selectrange> |