Intl.Locale

Overview

The Intl.Locale API parses Unicode locale identifiers, with language, region, and script codes, such as zh-Hans-CN or en-GB.

Browser support

Feature	Desktop				Mobile
Feature	Chrome	Edge	Firefox	Safari	Chrome Android	Safari iOS
`javascript.builtins.Intl.Locale`	74	79	75	14	74	14
Built-in object
`Intl.Locale.Locale` The Intl.Locale() constructor creates Intl.Locale objects.	74	79	75	14	74	14
`Intl.Locale.baseName` The baseName accessor property of Intl.Locale instances returns a substring of this locale's string representation, containing core information about this locale, including the language, script, region, and variants, if available.	74	79	75	14	74	14
`Intl.Locale.calendar` The calendar accessor property of Intl.Locale instances returns the calendar type for this locale.	74	79	75	14	74	14
`Intl.Locale.caseFirst` The caseFirst accessor property of Intl.Locale instances returns whether case is taken into account for this locale's collation rules.	74	79	75	14	74	14
`Intl.Locale.collation` The collation accessor property of Intl.Locale instances returns the collation type for this locale, which is used to order strings according to the locale's rules.	74	79	75	14	74	14
`Intl.Locale.hourCycle` The hourCycle accessor property of Intl.Locale instances returns the hour cycle type for this locale.	74	79	75	14	74	14
`Intl.Locale.language` The language accessor property of Intl.Locale instances returns the language associated with this locale.	74	79	75	14	74	14
`Intl.Locale.maximize` The maximize() method of Intl.Locale instances gets the most likely values for the language, script, and region of this locale based on existing values.	74	79	75	14	74	14
`Intl.Locale.minimize` The minimize() method of Intl.Locale instances attempts to remove information about this locale that would be added by calling Intl/Locale/maximize.	74	79	75	14	74	14
`Intl.Locale.numberingSystem` The numberingSystem accessor property of Intl.Locale instances returns the numeral system for this locale.	74	79	75	14	74	14
`Intl.Locale.numeric` The numeric accessor property of Intl.Locale instances returns whether this locale has special collation handling for numeric characters.	74	79	75	14	74	14
`Intl.Locale.region` The region accessor property of Intl.Locale instances returns the region of the world (usually a country) associated with this locale.	74	79	75	14	74	14
`Intl.Locale.script` The script accessor property of Intl.Locale instances returns the script used for writing the particular language used in this locale.	74	79	75	14	74	14
`Intl.Locale.toString` The toString() method of Intl.Locale instances returns this Locale's full locale identifier string.	74	79	75	14	74	14

1+Supported (version) Not supported ※Has note Sub-feature descriptions sourced from MDN Web Docs (CC BY-SA 2.5)

Syntax

JAVASCRIPT

const locale = new Intl.Locale('ja-JP-u-ca-japanese');
locale.language;  // 'ja'
locale.region;    // 'JP'
locale.calendar;  // 'japanese'

Live demo

roke-lidentifier object and.

PreviewFullscreen

option withroke-l

Calendar, numberingSystem equal. option also specifiedpossible.

PreviewFullscreen

roke-l. Parse

roke-lstring structureizationeachpartial to akses.

PreviewFullscreen

Use cases

Using Intl.Locale
The Intl.Locale API parses Unicode locale identifiers, with language, region, and script codes, such as zh-Hans-CN or en-GB.

Cautions

No specific concerns. Stable across all major browsers.

Overview

Browser support

Syntax

Live demo

Intl.Locale

option withroke-l

roke-l. Parse

Use cases

Using Intl.Locale

Cautions

Accessibility

Related links