javascript / latest / global_objects / intl / pluralrules.html /

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 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