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.

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

BCD tables only load in the browser

Див. також