Date.prototype.getTimezoneOffset()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die getTimezoneOffset() Methode von Date Instanzen gibt die Differenz in Minuten zwischen diesem Datum, wie es in der UTC-Zeitzone bewertet wird, und dem gleichen Datum, wie es in der lokalen Zeitzone bewertet wird, 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, wie es in der UTC-Zeitzone bewertet wird, und wie es in der lokalen Zeitzone bewertet wird, darstellt. Der tatsächliche lokale Zeit-Algorithmus ist implementationsspezifisch, und der Rückgabewert darf in Laufzeiten ohne geeignete Daten Null sein. Gibt NaN zurück, wenn das Datum ungültig ist.
Beschreibung
date.getTimezoneOffset() gibt die Differenz in Minuten zwischen date, wie es in der UTC-Zeitzone bewertet wird, und wie es in der lokalen Zeitzone bewertet wird, zurück – das heißt, die Zeitzone des Hostsystems, in dem der Browser genutzt wird (wenn der Code aus dem Web in einem Browser ausgeführt wird), oder anderweitig das Hostsystem von welchem beliebigen JavaScript-Laufzeitumgebung (zum Beispiel einer Node.js-Umgebung), in der der Code ausgeführt wird.
Negative und positive Werte
Die Zahl der von getTimezoneOffset() zurückgegebenen Minuten ist positiv, wenn die lokale Zeitzone hinter UTC liegt, und negativ, wenn die lokale Zeitzone vor UTC liegt. Zum Beispiel wird für UTC+10 -600 zurückgegeben.
| Aktuelle Zeitzone | Rückgabewert |
|---|---|
| UTC-8 | 480 |
| UTC | 0 |
| UTC+3 | -180 |
Variierende Ergebnisse in Sommerzeitregionen
In einer Region, die jährlich in die und aus der Sommerzeit (DST) wechselt, kann sich die Anzahl der Minuten, die durch Aufruf von getTimezoneOffset() zurückgegeben werden, uneinheitlich ändern, wenn sich das date ändert.
Hinweis:
Das Verhalten von getTimezoneOffset() wird niemals basierend auf der Zeit, wann der Code ausgeführt wird, abweichen – sein Verhalten ist immer konsistent, wenn es in derselben Region ausgeführt wird. Nur der Wert von date beeinflusst das Ergebnis.
Hinweis: Viele Länder haben experimentiert, die Uhrzeit nicht zweimal im Jahr zu ändern, was bedeutet, dass die Sommerzeit auch über den Winter andauern kann. Zum Beispiel dauerte im Vereinigten Königreich die Sommerzeit vom 18. Februar 1968 um 2:00 Uhr bis zum 31. Oktober 1971 um 3:00 Uhr, sodass während des Winters die Uhren nicht zurückgestellt wurden.
In den meisten Implementierungen wird die IANA-Zeitzonen-Datenbank (tzdata) verwendet, um den Offset der lokalen Zeitzone zum Zeitpunkt des date genau zu bestimmen. Wenn solche Informationen jedoch nicht verfügbar sind, kann eine Implementierung Null zurückgeben.
Beispiele
Verwendung von getTimezoneOffset()
// 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, die die Sommerzeit verwenden, kann sich der Rückgabewert basierend auf der Jahreszeit, in der sich das date befindet, ändern. Unten ist die Ausgabe in einer Laufzeit in New York, wo die Zeitzone UTC-05:00 ist.
const nyOffsetSummer = new Date("2022-02-01").getTimezoneOffset(); // 300
const nyOffsetWinter = new Date("2022-08-01").getTimezoneOffset(); // 240
getTimezoneOffset() und historische Daten
Aus historischen Gründen kann sich die Zeitzone einer Region ständig ändern, selbst ohne Berücksichtigung der Sommerzeit. Zum Beispiel ist unten die Ausgabe in einer Laufzeit 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
Das liegt daran, dass während des Sino-Japanischen Kriegs, als Shanghai unter japanischer Kontrolle stand, die Zeitzone auf UTC+09:00 geändert wurde, um mit der japanischen Zeitzone übereinzustimmen (tatsächlich war es eine "Ganzjahres-Sommerzeit"), und dies wurde in der IANA-Datenbank aufgezeichnet.
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.gettimezoneoffset |