Limited supportUseful for calendars, scheduling interfaces, and region-aware formatting logic.
Internationalization (Intl) Limited support

Intl.Locale info

Intl.Locale info exposes locale-specific metadata such as week settings and hour cycle preferences. It helps applications adapt to regional conventions more accurately.

IntlLocaleRegional settings

Overview

Intl.Locale info exposes locale-specific metadata such as week settings and hour cycle preferences. It helps applications adapt to regional conventions more accurately.

Browser support

Feature Desktop Mobile
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
javascript.builtins.Intl.Locale.getCalendars
130
130
17
130
17
Built-in object
Intl.Locale.getCollations

The getCollations() method of Intl.Locale instances returns a list of one or more collation types for this locale.
130
130
17
130
17
Intl.Locale.getHourCycles

The getHourCycles() method of Intl.Locale instances returns a list of one or more unique hour cycle identifiers for this locale.
130
130
17
130
17
Intl.Locale.getNumberingSystems

The getNumberingSystems() method of Intl.Locale instances returns a list of one or more unique numbering system identifiers for this locale.
130
130
17
130
17
Intl.Locale.getTextInfo

The getTextInfo() method of Intl.Locale instances returns the ordering of characters indicated by either ltr (left-to-right) or by rtl (right-to-left) for this locale.
130
130
17
130
17
Intl.Locale.getTimeZones

The getTimeZones() method of Intl.Locale instances returns a list of supported time zones for this locale.
130
130
17
130
17
Intl.Locale.getWeekInfo

The getWeekInfo() method of Intl.Locale instances returns a weekInfo object with the properties firstDay, weekend and minimalDays for this locale.
130
130
17
130
17
1+Supported (version) Not supported ※Has note Sub-feature descriptions sourced from MDN Web Docs (CC BY-SA 2.5)
Notes 2 item(s)
Implementation note
  • Previously available under a different name: calendars (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: calendars (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: calendars (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: calendars (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: calendars (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: collations (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: collations (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: collations (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: collations (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: collations (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: hourCycles (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: hourCycles (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: hourCycles (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: hourCycles (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: hourCycles (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: numberingSystems (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: numberingSystems (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: numberingSystems (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: numberingSystems (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: numberingSystems (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: textInfo (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: textInfo (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: textInfo (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: textInfo (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: textInfo (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: timeZones (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: timeZones (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: timeZones (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: timeZones (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: timeZones (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: weekInfo (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: weekInfo (99)
  • Implemented as an accessor property.
Notes 3 item(s)
Removed
  • This feature was removed in a later browser version (preview)
Implementation note
  • Previously available under a different name: weekInfo (15.4)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: weekInfo (99)
  • Implemented as an accessor property.
Notes 2 item(s)
Implementation note
  • Previously available under a different name: weekInfo (15.4)
  • Implemented as an accessor property.

Syntax

JAVASCRIPT 
// Intl.Locale info example
// See MDN Web Docs for details

Live demo

Inspect locale calendar info

Read weekInfo, hour cycle, and calendars from Intl.Locale when supported.

JavaScript
Output
Press the Run button

Compare multiple locales

Inspect locale data differences across English, Japanese, and Arabic locales.

JavaScript
Output
Press the Run button

Build a locale summary row

Create a compact UI summary object from Intl.Locale fields.

JavaScript
Output
Press the Run button

Use cases

  • Localized calendars

    Adjust first-day-of-week behavior and related layout rules to match user expectations.

  • Regional time displays

    Align hour-cycle decisions with locale-specific preferences instead of assuming one global rule.

Cautions

  • Locale metadata supports presentation choices, but products still need explicit policy decisions for shared experiences.
  • Do not overfit UI behavior to locale data if the underlying business rule should remain fixed.

Accessibility

  • Locale-aware calendar and time interfaces are easier to understand for users relying on consistent regional conventions.
  • Accurate locale handling reduces ambiguity in spoken and visual time information.

Related links

Powered by web-features