Date.prototype.getTimezoneOffset()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode getTimezoneOffset() von Date-Instanzen gibt die Differenz in Minuten zwischen diesem Datum in der UTC-Zeitzone und demselben Datum in der lokalen Zeitzone zurück.
Probieren Sie es aus
const date1 = new Date("August 19, 1975 23:15:30 GMT+07:00");
const date2 = new Date("August 19, 1975 23:15:30 GMT-02:00");
console.log(date1.getTimezoneOffset());
// Expected output: your local timezone offset in minutes
// (e.g., -120). NOT the timezone offset of the date object.
console.log(date1.getTimezoneOffset() === date2.getTimezoneOffset());
// Expected output: true
Syntax
getTimezoneOffset()
Parameter
Keine.
Rückgabewert
Eine Zahl, die die Differenz in Minuten zwischen dem Datum in der UTC-Zeitzone und dem Datum in der lokalen Zeitzone angibt. Der Algorithmus zur Bestimmung der lokalen Zeit ist implementierungsabhängig. In Laufzeitumgebungen ohne geeignete Daten darf der Rückgabewert null sein. Ist das Datum ungültig, wird NaN zurückgegeben.
Beschreibung
date.getTimezoneOffset() gibt die Differenz in Minuten zwischen date in der UTC-Zeitzone und date in der lokalen Zeitzone zurück. Die lokale Zeitzone ist die Zeitzone des Hostsystems, auf dem der Browser verwendet wird (wenn der Code im Webbrowser ausgeführt wird), beziehungsweise des Hostsystems der JavaScript-Laufzeitumgebung (beispielsweise einer Node.js-Umgebung), in der der Code ausgeführt wird.
Negative und positive Werte
Die von getTimezoneOffset() zurückgegebene Minutenzahl ist positiv, wenn die lokale Zeitzone hinter UTC liegt, und negativ, wenn sie vor UTC liegt. Für UTC+10 wird beispielsweise -600 zurückgegeben.
| Aktuelle Zeitzone | Rückgabewert |
|---|---|
| UTC-8 | 480 |
| UTC | 0 |
| UTC+3 | -180 |
Unterschiedliche Ergebnisse in Regionen mit Sommerzeit (DST)
In einer Region, die jährlich zwischen Sommerzeit (DST) und Normalzeit wechselt, kann die von getTimezoneOffset() zurückgegebene Minutenzahl je nach Wert von date unterschiedlich sein.
Hinweis:
Das Verhalten von getTimezoneOffset() hängt niemals davon ab, wann der Code ausgeführt wird – bei Ausführung in derselben Region ist es stets konsistent. Nur der Wert von date beeinflusst das Ergebnis.
Hinweis: Viele Länder haben damit experimentiert, die Uhrzeit nicht zweimal im Jahr umzustellen. Dadurch blieb die Sommerzeit auch im Winter bestehen. Im Vereinigten Königreich beispielsweise galt die Sommerzeit vom 18. Februar 1968 um 2:00 Uhr bis zum 31. Oktober 1971 um 3:00 Uhr; die Uhren wurden im Winter also nicht zurückgestellt.
In den meisten Implementierungen wird die IANA-Zeitzonendatenbank (tzdata) verwendet, um den Zeitunterschied zur lokalen Zeitzone zum Zeitpunkt von date genau zu bestimmen. Sind diese Informationen nicht verfügbar, kann eine Implementierung null zurückgeben.
Beispiele
>getTimezoneOffset() verwenden
// Create a Date instance for the current time
const currentLocalDate = new Date();
// Create a Date instance for 03:24 GMT-0200 on May 1st in 2016
const laborDay2016at0324GMTminus2 = new Date("2016-05-01T03:24:00-02:00");
currentLocalDate.getTimezoneOffset() ===
laborDay2016at0324GMTminus2.getTimezoneOffset();
// true, always, in any timezone that doesn't annually shift in and out of DST
// false, sometimes, in any timezone that annually shifts in and out of DST
getTimezoneOffset() und Sommerzeit
In Regionen mit Sommerzeit kann sich der Rückgabewert je nach Jahreszeit, in die date fällt, ändern. Im Folgenden sehen Sie die Ausgabe einer Laufzeitumgebung in New York, wo die Zeitzone UTC-05:00 ist.
const nyOffsetWinter = new Date("2022-02-01").getTimezoneOffset(); // 300
const nyOffsetSummer = new Date("2022-08-01").getTimezoneOffset(); // 240
getTimezoneOffset() und historische Daten
Aus historischen Gründen kann sich die Zeitzone einer Region auch unabhängig von der Sommerzeit immer wieder ändern. Im Folgenden sehen Sie beispielsweise die Ausgabe einer Laufzeitumgebung in Shanghai, wo die Zeitzone UTC+08:00 ist.
const shModernOffset = new Date("2022-01-27").getTimezoneOffset(); // -480
const shHistoricalOffset = new Date("1943-01-27").getTimezoneOffset(); // -540
Der Grund dafür ist, dass Shanghais Zeitzone während des Zweiten Japanisch-Chinesischen Kriegs, als die Stadt unter japanischer Kontrolle stand, auf UTC+09:00 umgestellt wurde, um sie an die Zeitzone Japans anzugleichen. Dies entsprach praktisch einer ganzjährigen Sommerzeit und wurde in der IANA-Datenbank erfasst.
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-date.prototype.gettimezoneoffset> |