Date.prototype.getTimezoneOffset()

Syntax

dateObj.getTimezoneOffset()

Rückgabewert

Eine Zahl, welche den Unterschied zwischen der UTC und der aktuellen Ortszeit (Einstellung des Hostsystems) in Minuten repräsentiert.

Beschreibung

Der Zeitzonen-Offset ist der Unterschied, in Minuten, zwischen der Weltzeit (UTC) und der lokalen Zeit. Das bedeutet, dass die Anzahl der Minuten eine positive Zahl ist, wenn die lokale Zeit  hinterher geht, und eine negative Zahl ist, wenn die lokale Zeit voraus geht. Zum Beispiel gibt die Methode für die Zeitzone UTC+10 (Ost Australische Standardzeit)  -600 zurück.

Das zurückgegebene Zeitzonen-Offset ist immer das zu dem Date-Objekt zugehörige Offset. Wenn das Hostsystem für die Sommerzeit konfiguriert ist, ändert sich das Offset je nach Datum und Uhrzeit des Datums und der Sommerzeit.

Beispiele

Einsatz von getTimezoneOffset()

// Gibt das aktuelle Zeitzonen-Offset für das Hostsystem zurück.
var x = new Date();
var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60;

// Gibt das Zeitzonen Offset des Internationalen Tag der Arbeit (1. Mai) in 2016 zurück.
// Vorsicht beim Einsatz des Date() Konstruktors, denn dieser Benutzt den 0-indizierten Monath
// so dass Mai durch 4 (und nicht durch 5) repräsentiert wird.
var labourDay = new Date(2016, 4, 1);
var labourDayOffset = labourDay.getTimezoneOffset() / 60;

Spezifikationen

Browserkompatibilität

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.