The Intl.PluralRules
object enables plural-sensitive formatting and plural-related language rules.
Intl.PluralRules
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 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:
// 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
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | Deno | Node.js | |
PluralRules |
63
|
18
|
58
|
No
|
50
|
13
|
63
|
63
|
58
|
46
|
13
|
8.0
|
1.8
|
10.0.0
Before version 13.0.0, only the locale data for
en-US is available by default. See
the PluralRules() constructor for more details.
|
PluralRules |
63
|
18
|
58
|
No
|
50
|
13
|
63
|
63
|
58
|
46
|
13
|
8.0
|
1.8
|
13.0.0
10.0.0
Before version 13.0.0, only the locale data for
en-US is available by default. When other locales are specified, the
PluralRules instance silently falls back to
en-US . To make full ICU (locale) data available before version 13, see
Node.js documentation on the --with-intl option and how to provide the data.
|
resolvedOptions |
63
|
18
|
58
|
No
|
50
|
13
|
63
|
63
|
58
|
46
|
13
|
8.0
|
1.8
|
10.0.0
Before version 13.0.0, only the locale data for
en-US is available by default. See
the PluralRules() constructor for more details.
|
select |
63
|
18
|
58
|
No
|
50
|
13
|
63
|
63
|
58
|
46
|
13
|
8.0
|
1.8
|
10.0.0
Before version 13.0.0, only the locale data for
en-US is available by default. See
the PluralRules() constructor for more details.
|
selectRange |
No
|
No
|
No
|
No
|
No
|
15.4
|
No
|
No
|
No
|
No
|
15.4
|
No
|
No
|
No
|
supportedLocalesOf |
63
|
18
|
58
|
No
|
50
|
13
|
63
|
63
|
58
|
46
|
13
|
8.0
|
1.8
|
10.0.0
Before version 13.0.0, only the locale data for
en-US is available by default. See
the PluralRules() constructor for more details.
|
See also
© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules