W3cubDocs

/JavaScript

Intl.pluralRules

The Intl.PluralRules object enables plural-sensitive formatting and plural-related language rules.

Constructor

Intl.PluralRules.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.

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 compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
PluralRules 63 18 58 No 50 13
PluralRules() constructor 63 18 58 No 50 13
resolvedOptions 63 18 58 No 50 13
select 63 18 58 No 50 13
supportedLocalesOf 63 18 58 No 50 13
Mobile
Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
PluralRules 63 63 58 46 13 8.0
PluralRules() constructor 63 63 58 46 13 8.0
resolvedOptions 63 63 58 46 13 8.0
select 63 63 58 46 13 8.0
supportedLocalesOf 63 63 58 46 13 8.0
Server
Node.js
PluralRules 10.0.0
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() constructor 13.0.0
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 for versions prior to 13, see Node.js documentation on the --with-intl option and how to provide the data.
resolvedOptions 10.0.0
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 10.0.0
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.
supportedLocalesOf 10.0.0
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–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/PluralRules