Date.prototype.getTimezoneOffset()

Keine.

Eine Zahl, die die Differenz in Minuten zwischen dem Datum darstellt, wie es in der UTC-Zeitzone und wie es in der lokalen Zeitzone bewertet wird. Der tatsächliche Algorithmus zur Bestimmung der lokalen Zeit ist implementationsdefiniert und der Rückgabewert darf in Laufzeiten ohne entsprechende Daten null sein. Gibt NaN zurück, wenn das Datum ungültig ist.

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 ist die Zeitzone des Hostsystems, in dem der Browser verwendet wird (wenn der Code im Web in einem Browser ausgeführt wird), oder anderweitig das Hostsystem der JavaScript-Laufzeitumgebung (zum Beispiel ein Node.js-Umfeld), in der der Code ausgeführt wird.

Die Anzahl der von getTimezoneOffset() zurückgegebenen Minuten ist positiv, wenn die lokale Zeitzone hinter UTC liegt, und negativ, wenn die lokale Zeitzone vor UTC liegt. Beispielsweise wird für UTC+10 -600 zurückgegeben.

In einer Region, die jährlich zwischen Sommerzeit (DST) wechselt, kann die Anzahl der Minuten, die durch Aufrufen von getTimezoneOffset() zurückgegeben werden, je nach date ungleichmäßig sein.

Note: Das Verhalten von getTimezoneOffset() wird nie unterschiedlich sein, basierend auf der Zeit, zu der der Code ausgeführt wird – sein Verhalten ist immer konsistent, wenn es in derselben Region ausgeführt wird. Nur der Wert von date beeinflusst das Ergebnis.

Note: Viele Länder haben experimentiert, die Zeit nicht zweimal im Jahr zu ändern und dies bedeutete, dass die Sommerzeit auch im Winter fortgesetzt wurde. Beispielsweise 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 im Winter die Uhren 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.

In Regionen, die DST verwenden, kann sich der Rückgabewert je nach Jahreszeit, in der sich date befindet, ändern. Nachfolgend 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

Aus historischen Gründen kann sich die Zeitzone, in der sich eine Region befindet, ständig ändern, selbst wenn DST außer Acht gelassen wird. Beispielsweise 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

Dies liegt daran, dass während des Sino-Japanischen Krieges, 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 DST“), und dies wurde in der IANA-Datenbank aufgezeichnet.

• Date