【Ruby3.x】Time::gmt_offset()メソッドの使い方

gmt_offsetメソッドは、レシーバであるTimeオブジェクトが表す時刻の、協定世界時（UTC）からのオフセット秒数を整数で返すメソッドです。このオフセットは、TimeオブジェクトのローカルタイムゾーンがUTCよりどれだけ進んでいるか、あるいは遅れているかを秒単位で示します。例えば、日本標準時（JST）はUTCより9時間進んでいるため、JSTのTimeオブジェクトからは32400（9時間 × 60分 × 60秒）が返されます。

オフセットは、Timeオブジェクトが持つタイムゾーン情報に基づいて計算されます。夏時間（サマータイム）が適用される地域の場合、期間に応じてオフセット値も自動調整されます。この特性により、異なるタイムゾーン間の時刻変換や比較、ユーザーのタイムゾーンに合わせた時刻表示など、タイムゾーンを考慮した正確な時刻処理を行う際に活用されます。このメソッドはutc_offsetメソッドの別名でもあり、両者は同じ動作をします。

Copy
1current_time = Time.now
2offset_in_seconds = current_time.gmt_offset
3puts offset_in_seconds

引数なし

引数はありません

Integer

Timeオブジェクトが表す時刻の、協定世界時（UTC）からの時差を秒単位で返します。正の値はUTCより進んでいることを、負の値はUTCより遅れていることを示します。