The getTimezoneOffset()
method returns the time zone difference, in minutes, from current locale (host system settings) to UTC.
Syntax
dateObj.getTimezoneOffset()
Return value
A number representing the time-zone offset from UTC, in minutes, for the date based on current host system settings.
Description
The time-zone offset is the difference, in minutes, between UTC and local time. 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. Where 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 var x = new Date(); var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60; // Get timezone offset for International Labour Day (1 May) in 2016 var labourDay = new Date(2016,4,1) var labourDayOffset = labourDay.getTimezoneOffset() / 60;
Specifications
Specification | Status | Comment |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initial definition. Implemented in JavaScript 1.0. |
ECMAScript 5.1 (ECMA-262) The definition of 'Date.prototype.getTimezoneOffset' in that specification. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Date.prototype.getTimezoneOffset' in that specification. |
Standard | |
ECMAScript Latest Draft (ECMA-262) The definition of 'Date.prototype.getTimezoneOffset' in that specification. |
Draft |
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.
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | 5 | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |