The Intl.Locale.prototype.numberingSystem
property is an accessor property that returns the numeral system used by the locale.
Description
A numeral system is a system for expressing numbers. The numberingSystem property helps to represent the different numeral systems used by various countries, regions, and cultures around the world. As with most internationalization schemas, the numeral systems that can be represented in a Locale
object by numberingSystem
are standardized by Unicode. A table of the standard Unicode numeral systems can be seen below.
Value | Description |
---|---|
adlm | Adlam digits |
ahom | Ahom digits |
arab | Arabic-Indic digits |
arabext | Extended Arabic-Indic digits |
armn | Armenian upper case numerals — algorithmic |
armnlow | Armenian lower case numerals — algorithmic |
bali | Balinese digits |
beng | Bengali digits |
bhks | Bhaiksuki digits |
brah | Brahmi digits |
cakm | Chakma digits |
cham | Cham digits |
cyrl | Cyrillic numerals — algorithmic |
deva | Devanagari digits |
ethi | Ethiopic numerals — algorithmic |
finance | Financial numerals — may be algorithmic |
fullwide | Full width digits |
geor | Georgian numerals — algorithmic |
gong | Gunjala Gondi digits |
gonm | Masaram Gondi digits |
grek | Greek upper case numerals — algorithmic |
greklow | Greek lower case numerals — algorithmic |
gujr | Gujarati digits |
guru | Gurmukhi digits |
hanidays | Han-character day-of-month numbering for lunar/other traditional calendars |
hanidec | Positional decimal system using Chinese number ideographs as digits |
hans | Simplified Chinese numerals — algorithmic |
hansfin | Simplified Chinese financial numerals — algorithmic |
hant | Traditional Chinese numerals — algorithmic |
hantfin | Traditional Chinese financial numerals — algorithmic |
hebr | Hebrew numerals — algorithmic |
hmng | Pahawh Hmong digits |
hmnp | Nyiakeng Puachue Hmong digits |
java | Javanese digits |
jpan | Japanese numerals — algorithmic |
jpanfin | Japanese financial numerals — algorithmic |
jpanyear | Japanese first-year Gannen numbering for Japanese calendar |
kali | Kayah Li digits |
khmr | Khmer digits |
knda | Kannada digits |
lana | Tai Tham Hora (secular) digits |
lanatham | Tai Tham Tham (ecclesiastical) digits |
laoo | Lao digits |
latn | Latin digits |
lepc | Lepcha digits |
limb | Limbu digits |
mathbold | Mathematical bold digits |
mathdbl | Mathematical double-struck digits |
mathmono | Mathematical monospace digits |
mathsanb | Mathematical sans-serif bold digits |
mathsans | Mathematical sans-serif digits |
mlym | Malayalam digits |
modi | Modi digits |
mong | Mongolian digits |
mroo | Mro digits |
mtei | Meetei Mayek digits |
mymr | Myanmar digits |
mymrshan | Myanmar Shan digits |
mymrtlng | Myanmar Tai Laing digits |
native | Native digits |
newa | Newa digits |
nkoo | N'Ko digits |
olck | Ol Chiki digits |
orya | Oriya digits |
osma | Osmanya digits |
rohg | Hanifi Rohingya digits |
roman | Roman upper case numerals — algorithmic |
romanlow | Roman lowercase numerals — algorithmic |
saur | Saurashtra digits |
shrd | Sharada digits |
sind | Khudawadi digits |
sinh | Sinhala Lith digits |
sora | Sora_Sompeng digits |
sund | Sundanese digits |
takr | Takri digits |
talu | New Tai Lue digits |
taml | Tamil numerals — algorithmic |
tamldec | Modern Tamil decimal digits |
telu | Telugu digits |
thai | Thai digits |
tirh | Tirhuta digits |
tibt | Tibetan digits |
traditio | Traditional numerals — may be algorithmic |
vaii | Vai digits |
wara | Warang Citi digits |
wcho | Wancho digits |
Examples
Setting the numberingSystem
value via the locale string
In the Unicode locale string spec, the values that numberingSystem
represents correspond to the key nu
. nu
is considered a locale string "extension subtag". These subtags add additional data about the locale, and are added to locale identifiers by first adding the -u
key. To set the numberingSystem
value via the string argument to the Locale
constructor, first add the -u
extension key. Next, add the -nu
extension key to indicate that you are adding a value for numberingSystem
. Finally, add the numberingSystem
value to the string.
let numberingSystemViaStr = new Intl.Locale("fr-Latn-FR-u-nu-mong"); console.log(numberingSystemStr.numberingSystem); // Prints "mong"
Setting the numberingSystem
value via the configuration object argument
The Intl.Locale
constructor has an optional configuration object argument, which can be used to pass extension types. Set the numberingSystem property of the configuration object to your desired numberingSystem
value and pass it into the constructor.
let numberingSystemViaObj= new Intl.Locale("en-Latn-US", {numberingSystem: "latn"}); console.log(us12hour.numberingSystem); // Prints "latn"
Specifications
Specification | Status | Comment |
---|---|---|
Intl.Locale proposal | Stage 3 |
Browser compatibility
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
numberingSystem |
Chrome Full support 74 | Edge No support No | Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android Full support 74 | Chrome Android Full support 74 | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android No support No | nodejs No support No |
Legend
- Full support
- Full support
- No support
- No support