【Node.js24.x】Date::getTimezoneOffset()メソッドの使い方

getTimezoneOffsetメソッドは、Node.jsのDateオブジェクトが表すローカル時間とUTC（協定世界時）との間のタイムゾーンオフセット（時差）を分単位で取得するメソッドです。

このメソッドは、Dateオブジェクトに設定されている日付と時刻が、実行中のシステム（環境）のローカルタイムゾーンにおいて、UTCからどれだけずれているかを示します。戻り値は常に整数で、ローカルタイムゾーンがUTCより進んでいる場合（例えば、日本時間のようにUTC+9の場合）、負の値が返されます。具体的には、9時間進んでいる場合は -540（-9時間 × 60分）が返されます。逆に、ローカルタイムゾーンがUTCより遅れている場合（例えば、アメリカ東部時間のようにUTC-4の場合）、正の値が返されます。この場合は 240（4時間 × 60分）が返されます。

このオフセットは、サマータイム（夏時間）が適用される地域では、対象となるDateオブジェクトの日付によって変動する可能性がある点に注意が必要です。getTimezoneOffsetメソッドは、主に異なるタイムゾーン間での時刻計算や、特定の地域の時刻を正確に扱う必要があるシステムで、ローカルタイムゾーンのずれを考慮する際に利用されます。日付や時刻の国際化対応や、ユーザーの環境に応じた時刻表示を行う際に重要な役割を果たします。

Copy
1const d = new Date();
2const timezoneOffsetMinutes = d.getTimezoneOffset();
3console.log(timezoneOffsetMinutes);

引数なし

引数はありません

number

このメソッドは、ローカルタイムゾーンとUTC（協定世界時）との差を分単位で返します。