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 getTimezoneOffset() Methode von Date Instanzen gibt die Differenz in Minuten zwischen diesem Datum, wie es in der UTC-Zeitzone bewertet wird, und dem gleichen Datum, wie es in der lokalen Zeitzone bewertet wird, zurück.
Probieren Sie es aus
const date1 = new Date("August 19, 1975 23:15:30 GMT+07:00");
const date2 = new Date("August 19, 1975 23:15:30 GMT-02:00");
console.log(date1.getTimezoneOffset());
// Expected output: your local timezone offset in minutes
// (e.g., -120). NOT the timezone offset of the date object.
console.log(date1.getTimezoneOffset() === date2.getTimezoneOffset());
// Expected output: true
Syntax
getTimezoneOffset()
Parameter
Keine.
Rückgabewert
Eine Zahl, die die Differenz in Minuten zwischen dem Datum, wie es in der UTC-Zeitzone bewertet wird, und wie es in der lokalen Zeitzone bewertet wird, darstellt. Der tatsächliche lokale Zeitalgorithmus ist implementationsspezifisch, und der Rückgabewert darf in Laufzeiten ohne entsprechende Daten null sein. Gibt NaN zurück, wenn das Datum ungültig ist.
Beschreibung
date.getTimezoneOffset() gibt die Differenz in Minuten zwischen date, bewertet in der UTC-Zeitzone, und bewertet in der lokalen Zeitzone zurück — das heißt, 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, welches auch immer die JavaScript-Laufzeit (zum Beispiel eine Node.js-Umgebung) ist, in der der Code ausgeführt wird.
Negative und positive Werte
Die von getTimezoneOffset() zurückgegebenen Minuten sind 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
In einer Region, die jährlich zwischen Sommerzeit (DST) und Normalzeit wechselt, kann die Anzahl der von getTimezoneOffset() zurückgegebenen Minuten uneinheitlich sein, je nach date.
Hinweis:
Das Verhalten von getTimezoneOffset() wird niemals aufgrund der Zeit, wann der Code ausgeführt wird, unterschiedlich sein — 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 experimentiert, die Zeit nicht zweimal im Jahr zu ändern, was bedeutete, dass die Sommerzeit auch im Winter fortgesetzt wurde. Beispielsweise dauerte in Großbritannien 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. Ist eine solche Information nicht verfügbar, kann eine Implementierung null zurückgeben.
Beispiele
Verwendung von getTimezoneOffset()
// 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 nutzen, kann sich der Rückgabewert basierend auf der Jahreszeit, in der sich date befindet, ändern. Unten 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
getTimezoneOffset() und historische Daten
Aus historischen Gründen kann sich die Zeitzone einer Region ständig ändern, auch abgesehen von der Sommerzeit. Unten ist 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 sie mit der japanischen abzugleichen (tatsächlich war es eine "ganzjährige Sommerzeit"), und dies in der IANA-Datenbank festgehalten wurde.
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.gettimezoneoffset |