Date.prototype.getTimezoneOffset()

Метод getTimezoneOffset() повертає різніцю, у хвилинах, між поточним місцевим часовим поясом (налаштування системи хоста) та UTC.

Синтаксис

dateObj.getTimezoneOffset()

Повертає

Число, що відображає зсув часового поясу, в хвилинах, від дати, що базується на поточних налаштуваннях системи, до UTC.

Опис

Зсув часового поясу - це різниця, у хвилинах, між місцевим часом та UTC (Coordinated Universal Time, Всесвітній координований час).

Зауважте, це означає, що зсув є додатнім, якщо локальний часовий пояс розташований за UTC, та від'ємним, якщо він розташований попереду. Наприклад, для часового поясу UTC+10:00 (Австралійський східний стандартний час, Час Чаморро), результатом буде -600.

Локальний часовий пояс UTC-8 UTC UTC+3
Значення, що повертається 480 0 -180

Зсув часового поясу, який повертається, стосується об'єкта Date, на якому викликається метод.

Якщо в системі налаштований перехід на літній час, зсув буде змінюватись, в залежності від дати та часу, які містить об'єкт Date, та дати та часу, на які впливає перехід на літній час.

Приклади

Використання getTimezoneOffset()

// Отримати зсув поточного часового поясу для хостового пристрою
let x = new Date();
let currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60;
// -3

// Отримати зсув часового поясу для Міжнародного дня праці (1 травня) у 2016 р.
// Будьте обережні, конструктор Date() рахує місяці з 0, тому травень
// передається числом 4 (а не 5)
let labourDay = new Date(2016, 4, 1)
let labourDayOffset = labourDay.getTimezoneOffset() / 60;

Специфікації

Специфікація
ECMAScript (ECMA-262)
The definition of 'Date.prototype.getTimezoneOffset' in that specification.

Сумісність з веб-переглядачами

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung InternetNode.js
getTimezoneOffsetChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support 5Opera Full support 3Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0nodejs Full support 0.1.100

Legend

Full support  
Full support

Див. також