Web/JavaScript/Reference/Global objects/Intl/Locale/numeric

The Intl.Locale.prototype.numeric property is an accessor property that returns whether the locale has special collation handling for numeric characters.

Description

Like Intl.Locale.caseFirst, numeric represents a modification to the collation rules utilized by the locale. numeric is a Boolean value, which means that it can be either true or false. If numeric is set to false, there will be no special handling of numeric values in strings. If numeric is set to true, then the locale will take numeric characters into account when collating strings. This special numeric handling means that sequences of decimal digits will be compared as numbers. For example, the string "A-21" will be considered less than "A-123".

Examples

Setting the numeric value via the locale string

In the Unicode locale string spec, the values that numeric represents correspond to the key kn. kn is considered a locale string "extension subtag". These subtags add additional data about the locale, and are added to locale identifiers by using the -u extension key. Thus, the numeric value can be added to the inital locale identifier string that is passed into the Locale constructor. To set the numeric value, first add the -u extension key to the string. Next, add the -kn extension key to indicate that you are adding a value for numeric. Finally, add the numeric value to the string. If you want to set numeric to true, simply adding the kn key will suffice. To set the value to false, you must specify in by adding "false" after the kn key.

let numericViaStr = new Intl.Locale("fr-Latn-FR-u-kn-false");
console.log(numericStr.numeric); // Prints "false"

Setting the numeric 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 numeric property of the configuration object to your desired numeric value and pass it into the constructor.

let numericViaObj= new Intl.Locale("en-Latn-US", {numeric: true});
console.log(us12hour.numeric); // Prints "true"

Specifications

Specification
ECMAScript Internationalization API (ECMA-402)

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
numeric	Chrome Full support 74	Edge Full support 79	Firefox Full support 75	IE No support No	Opera Full support 62	Safari Full support 14	WebView Android Full support 74	Chrome Android Full support 74	Firefox Android No support No	Opera Android Full support 53	Safari iOS Full support 14	Samsung Internet Android Full support 11.0	nodejs Full support 12.0.0 Notes' Full support 12.0.0 Notes' Notes' Before version 13.0.0, only the locale data for en-US is available by default. See the Locale() constructor for more details.

Legend

Full support  

Full support

No support  

No support

See implementation notes.'

See implementation notes.

See also

• Intl.Locale

Intl.Locale.prototype.numeric by Mozilla Contributors is licensed under CC-BY-SA 2.5.