Date.prototype.getTimezoneOffset()
Die getTimezoneOffset() Methode gibt den Unterschied zwischen der aktuellen Ortszeit (Einstellungen des Hostsystems) und der Weltzeit (UTC) in Minuten zurück.
Syntax
dateObj.getTimezoneOffset()Rückgabewert
Eine Zahl, welche den Unterschied zwischen der aktuellen Ortszeit (Einstellung des Hostsystems) und der UTC in Minuten repräsentiert.
Beschreibung
Der Zeitzonen-Offset ist der Unterschied, in Minuten, zwischen der lokalen Zeit und der Weltzeit (UTC). 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.
| Aktuelle Zeitzone | UTC-8 | UTC | UTC+3 |
| Rückgabewert | 480 | 0 | -180 |
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;
// 1
// 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 Monat
// 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
| Spezifikation | Status | Kommentar |
|---|---|---|
| ECMAScript 1st Edition (ECMA-262) | Standard | Initiale Definition. Implementiert in JavaScript 1.0. |
| ECMAScript 5.1 (ECMA-262) Die Definition von 'Date.prototype.getTimezoneOffset' in dieser Spezifikation. |
Standard | |
| ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Date.prototype.getTimezoneOffset' in dieser Spezifikation. |
Standard | |
| ECMAScript (ECMA-262) Die Definition von 'Date.prototype.getTimezoneOffset' in dieser Spezifikation. |
Lebender Standard |
Browserkompatibilität
BCD tables only load in the browser