Date.prototype.getTimezoneOffset()

getTimezoneOffset() メソッドは、（ホストシステム上における）現在のロケールから協定世界時 (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.

構文

dateObj.getTimezoneOffset()

戻り値

ホストシステム上の現在の日付から協定世界時 (UTC) までの分単位のタイムゾーンオフセットを表す数値です。

説明

タイムゾーンオフセットは、地方時から協定世界時 (UTC) までの間の分単位の差です。このオフセットは、地方時が UTC より遅れている時刻の場合は正の数になり、進んでいる時刻の場合は負の数になることを意味します。例えば、タイムゾーンが UTC+10:00（オーストラリア東部標準時、ロシアのウラジオストク時、チャモロ標準時）の場合、-600 が返されます。

返されるタイムゾーンオフセットは呼ばれた Date で適用されているものです。ホストシステムで夏時間が設定されている場合、Date が表す日時と夏時間が適用される日時によって、オフセットが変わります。

例

getTimezoneOffset() を使う

// Get current timezone offset for host device
var x = new Date();
var currentTimeZoneOffsetInHours = x.getTimezoneOffset() / 60;
// 1

// Get timezone offset for International Labour Day (May 1) in 2016
// Be careful, the Date() constructor uses 0-indexed month so May is
// represented with 4 (and not 5)
var labourDay = new Date(2016, 4, 1)
var labourDayOffset = labourDay.getTimezoneOffset() / 60;

仕様

ブラウザー実装状況

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.