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

The Intl.Locale.prototype.toString() returns the Locale's full locale identifier string.

Syntax

locale.toString()

Return value

The locale's Unicode locale identifier string.

Description

The Locale object is a JavaScript representation of a concept Unicode locale identifier. Information about a particular locale (language, script, calendar type, etc.) can be encoded in a locale identifier string. To make it easier to work with these locale identifiers, the Locale object was introduced to JavaScript. Calling the toString method on a Locale object will return the identifier string for that particular Locale. The toString method allows Locale instances to be provided as an argument to existing Intl constructors, serialized in JSON, or any other context where an exact string representation is useful.

Examples

Using toString

let myLocale = new Intl.Locale("fr-Latn-FR", {hourCycle: "h24", calendar: "gregory"});
console.log(myLocale.baseName); // Prints "fr-Latn-FR"
console.log(myLocale.toString()); // Prints "fr-Latn-FR-u-ca-gregory-hc-h24"

Specifications

Specification
ECMAScript Internationalization API (ECMA-402)

Browser compatibility

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
`toString`	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.