Intl.PluralRules
The Intl.PluralRules
object enables plural-sensitive formatting and plural-related language rules.
Constructor
Intl.PluralRules()
-
Creates a new
Intl.PluralRules
object.
Static methods
Intl.PluralRules.supportedLocalesOf()
-
Returns an array containing those of the provided locales that are supported without having to fall back to the runtime's default locale.
Instance properties
These properties are defined on Intl.PluralRules.prototype
and shared by all Intl.PluralRules
instances.
Intl.PluralRules.prototype.constructor
-
The constructor function that created the instance object. For
Intl.PluralRules
instances, the initial value is theIntl.PluralRules
constructor. Intl.PluralRules.prototype[@@toStringTag]
-
The initial value of the
@@toStringTag
property is the string"Intl.PluralRules"
. This property is used inObject.prototype.toString()
.
Instance methods
Intl.PluralRules.prototype.resolvedOptions()
-
Returns a new object with properties reflecting the locale and collation options computed during initialization of the object.
Intl.PluralRules.prototype.select()
-
Returns a string indicating which plural rule to use for locale-aware formatting.
Intl.PluralRules.prototype.selectRange()
-
This method receives two values and returns a string indicating which plural rule to use for locale-aware formatting.
Examples
Using locales
This example shows some of the variations in localized plural rules. In order to get the format of the language used in the user interface of your application, make sure to specify that language (and possibly some fallback languages) using the locales
argument:
js
// Arabic has different plural rules
new Intl.PluralRules("ar-EG").select(0);
// → 'zero'
new Intl.PluralRules("ar-EG").select(1);
// → 'one'
new Intl.PluralRules("ar-EG").select(2);
// → 'two'
new Intl.PluralRules("ar-EG").select(6);
// → 'few'
new Intl.PluralRules("ar-EG").select(18);
// → 'many'
Specifications
Specification |
---|
ECMAScript Internationalization API Specification # pluralrules-objects |
Browser compatibility
BCD tables only load in the browser