The getTimezoneOffset()
method returns the time zone difference, in minutes, from current locale (host system settings) to UTC.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
Syntax
dateObj.getTimezoneOffset()
Return value
A number representing the time-zone offset, in minutes, from the date based on current host system settings to UTC.
Description
The time-zone offset is the difference, in minutes, from local time to UTC.
Note that this means that the offset is positive if the local timezone is behind UTC, and negative if it is ahead. For example, for time zone UTC+10:00 (Australian Eastern Standard Time, Vladivostok Time, Chamorro Standard Time), -600
will be returned.
Current Locale | UTC-8 | UTC | UTC+3 |
---|---|---|---|
Return Value | 480 | 0 | -180 |
The time zone offset returned is the one that applies for the Date that it's called on.
If the host system is configured for daylight saving, the offset will change depending on the date and time that the Date represents and that daylight saving applies.
Examples
Using getTimezoneOffset()
// Get current timezone offset for host device let x = new Date(); let currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60; // 1 // Get timezone offset for International Labour Day (May 1) in 2016 // Be careful, the Date() constructor uses 0-indexed months, so May is // represented with 4 (and not 5) let labourDay = new Date(2016, 4, 1) let labourDayOffset = labourDay.getTimezoneOffset() / 60;
Specifications
Specification |
---|
ECMAScript (ECMA-262) The definition of 'Date.prototype.getTimezoneOffset' in that specification. |
Browser compatibility
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.
Desktop | Mobile | Server | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
getTimezoneOffset | Chrome Full support 1 | Edge Full support 12 | Firefox Full support 1 | IE Full support 5 | Opera Full support 3 | Safari Full support 1 | WebView Android Full support 1 | Chrome Android Full support 18 | Firefox Android Full support 4 | Opera Android Full support 10.1 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 | nodejs Full support 0.1.100 |
Legend
- Full support
- Full support