The getTimeZones()
method of Intl.Locale instances returns a list of supported time zones for this locale.
Note: In some versions of some browsers, this method was implemented as an accessor property called
timeZones
. However, because it returns a new array on each access, it is now implemented as a method to prevent the situation oflocale.timeZones === locale.timeZones
returningfalse
. Check the browser compatibility table for details.
Syntax
getTimeZones()
Parameters
None.
Return value
An array of strings representing supported time zones for the associated Locale
, where each value is an IANA time zone canonical name, sorted in alphabetical order. If the locale identifier does not contain a region subtag, the returned value is undefined
.
Examples
Obtaining supported time zones
List supported time zones for a given Locale
.
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getTimeZones()); // ["Africa/Cairo"]
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getTimeZones()); // ["Asia/Tokyo"]
const ar = new Intl.Locale("ar");
console.log(ar.getTimeZones()); // undefined
Specifications
Browser compatibility
See also
- Intl.Locale
- IANA time zone database on Wikipedia