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 Methode getTimezoneOffset() von Date Instanzen gibt die Differenz in Minuten zwischen diesem Datum im UTC-Zeitraum und demselben Datum im lokalen Zeitraum zurück.

Probieren Sie es aus

Syntax

js
getTimezoneOffset()

Parameter

Keine.

Rückgabewert

Eine Zahl, die die Differenz in Minuten zwischen dem Datum im UTC-Zeitraum und dem im lokalen Zeitraum darstellt. Der tatsächliche lokale Zeit-Algorithmus ist implementationsabhängig, 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 im UTC-Zeitraum und im lokalen Zeitraum zurück — das heißt, der Zeitzone des Hosts, in dem der Browser verwendet wird (wenn der Code im Web in einem Browser ausgeführt wird), oder anderweitig des Hostsystems, welcher JavaScript-Laufzeit (zum Beispiel einer Node.js Umgebung) der Code ausgeführt wird.

Negative und positive Werte

Die Anzahl der Minuten, die von getTimezoneOffset() zurückgegeben werden, 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

Unterschiedliche Ergebnisse in Regionen mit Sommerzeit (DST)

In einer Region, die jährlich in die Sommerzeit (DST) hinein- und herauswechselt, kann die Anzahl der Minuten, die durch Aufrufen von getTimezoneOffset() zurückgegeben werden, ungleichmäßig sein, je nachdem, wie date variiert.

Hinweis: Das Verhalten von getTimezoneOffset() wird sich nie aufgrund der Laufzeit unterscheiden – 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 damit experimentiert, die Zeit nicht zweimal im Jahr zu ändern, was bedeutete, dass die Sommerzeit auch im Winter fortgesetzt wurde. Zum Beispiel dauerte die Sommerzeit in Großbritannien vom 02:00 Uhr, den 18. Februar 1968, bis 03:00 Uhr, den 31. Oktober 1971, sodass die Uhren im Winter nicht zurückgestellt wurden.

In den meisten Implementierungen wird die IANA-Zeitzonendatenbank (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()

js
// 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 (DST) nutzen, kann sich der Rückgabewert je nach Jahreszeit, in der sich date befindet, ändern. Unten ist die Ausgabe in einer Laufzeit in New York, wo die Zeitzone UTC-05:00 ist.

js
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, auch ohne Berücksichtigung der Sommerzeit. Zum Beispiel ist unten die Ausgabe in einer Laufzeit in Shanghai, wo die Zeitzone UTC+08:00 ist.

js
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 Krieges, als Shanghai unter japanischer Kontrolle war, die Zeitzone auf UTC+09:00 geändert wurde, um mit Japan übereinzustimmen (in der Tat war es eine "ganzjährige Sommerzeit"), und dies wurde in der IANA-Datenbank verzeichnet.

Spezifikationen

Specification
ECMAScript Language Specification
# sec-date.prototype.gettimezoneoffset

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch