Intl.Locale.prototype.getTimeZones()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die getTimeZones()-Methode von Intl.Locale-Instanzen gibt eine Liste unterstützter Zeitzonen für dieses Locale zurück.

Hinweis: In einigen Versionen einiger Browser wurde diese Methode als Zugriffsproperty namens timeZones implementiert. Da sie jedoch bei jedem Zugriff ein neues Array zurückgibt, wird sie jetzt als Methode implementiert, um die Situation zu vermeiden, dass locale.timeZones === locale.timeZones false zurückgibt. Überprüfen Sie die Browser-Kompatibilitätstabelle für Details.

Syntax

js
getTimeZones()

Parameter

Keine.

Rückgabewert

Ein Array von Zeichenketten, das unterstützte Zeitzonen für das zugehörige Locale repräsentiert, wobei jeder Wert ein kanonischer IANA-Zeitzonenname ist, sortiert in alphabetischer Reihenfolge. Wenn der Locale-Identifier kein Region-Subtag enthält, ist der zurückgegebene Wert undefined.

Beachten Sie, dass sich die IANA-Datenbank von Zeit zu Zeit ändert, die Unicode CLDR-Datenbank (die von Browsern verwendet wird) alte Zeitzonennamen jedoch aus Stabilitätsgründen beibehält. Hier sind einige bemerkenswerte Namensänderungen:

Aktueller IANA-Name CDLR-Datenbank
America/Argentina/Buenos_Aires America/Buenos_Aires
Asia/Kolkata Asia/Calcutta
Asia/Ho_Chi_Minh Asia/Saigon
Europe/Kyiv Europe/Kiev

Einige Browser (Firefox) überschreiben diese alten Namen, während andere dies nicht tun (Safari und Chrome). Weitere Informationen finden Sie in der CLDR-Datenbank. (IANA-Namen sind mit "_iana" markiert, wenn sie unterschiedlich sind.) Es gibt eine Anstrengung in TC39, diese kanonischen Bezeichner richtig zu behandeln, die auch Links zu verwandten CLDR-Problemen enthält.

Beispiele

Ermitteln von unterstützten Zeitzonen

Listen Sie unterstützte Zeitzonen für ein gegebenes Locale auf.

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getTimeZones()); // ["Africa/Cairo"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getTimeZones()); // ["Asia/Tokyo"]
js
const ar = new Intl.Locale("ar");
console.log(ar.getTimeZones()); // undefined

Spezifikationen

Specification
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getTimeZones

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch