Date.prototype.getTimezoneOffset()

Keine.

Eine Zahl, die den Unterschied in Minuten zwischen dem Datum, wie es in der UTC-Zeitzone ausgewertet wird, und wie es in der lokalen Zeitzone ausgewertet wird, darstellt. Der tatsächliche lokale Zeit-Algorithmus ist implementierungsabhängig, und der Rückgabewert kann in Laufzeitumgebungen ohne entsprechende Informationen null sein. Gibt NaN zurück, wenn das Datum ungültig ist.

date.getTimezoneOffset() gibt den Unterschied in Minuten zwischen date, wie es in der UTC-Zeitzone ausgewertet wird, und wie es in der lokalen Zeitzone ausgewertet wird, zurück — das heißt, der Zeitzone des Hostsystems, in dem der Browser verwendet wird (falls der Code im Web ausgeführt wird), oder anderweitig des Hostsystems der jeweiligen JavaScript-Laufzeitumgebung (zum Beispiel einer Node.js-Umgebung), in der der Code ausgeführt wird.

Die von getTimezoneOffset() zurückgegebene Minutenanzahl 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.

In einer Region, die jährlich zwischen Sommerzeit (DST) und Normalzeit wechselt, kann die Anzahl der Minuten, die durch Aufruf von getTimezoneOffset() zurückgegeben wird, nicht einheitlich sein, wenn sich date ändert.

Note: Das Verhalten von getTimezoneOffset() ändert sich nie in Abhängigkeit von der Zeit, zu der der Code ausgeführt wird — sein Verhalten ist immer konsistent, wenn es in der gleichen Region ausgeführt wird. Nur der Wert von date beeinflusst das Ergebnis.

Note: Viele Länder haben experimentiert, die Zeitumstellung zweimal im Jahr abzuschaffen. Das bedeutete, dass die Sommerzeit in einigen Fällen auch im Winter fortgeführt wurde. Beispielsweise dauerte in Großbritannien die Sommerzeit von 2:00 Uhr am 18. Februar 1968 bis 3:00 Uhr am 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 präzise zu bestimmen. Falls solche Informationen nicht verfügbar sind, kann eine Implementierung null zurückgeben.

In Regionen, die DST verwenden, kann der Rückgabewert sich abhängig von der Jahreszeit, in der sich date befindet, ändern. Unten ist die Ausgabe in einer Laufzeitumgebung 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

Aus historischen Gründen kann sich die Zeitzone einer Region ständig ändern, selbst abgesehen von der Sommerzeit. Unten ist die Ausgabe in 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

Dies 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 sich an die japanische Zeitzone anzupassen (in der Praxis war es eine "ganzjährige Sommerzeit"), und dies wurde in der IANA-Datenbank aufgezeichnet.

• Date