【Ruby3.x】Time::tm::gmtoff()メソッドの使い方
gmtoffメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
gmtoffメソッドは、RubyのTimeオブジェクトが保持する時刻情報について、協定世界時（UTC、グリニッジ標準時）からのオフセット（ずれ）を秒単位で取得するメソッドです。
Timeオブジェクトは、特定の日時だけでなく、その時刻がどのタイムゾーンに属しているかという情報も内部的に持っていることがあります。gmtoffメソッドを呼び出すと、そのTimeオブジェクトが表す時刻のタイムゾーンにおいて、UTCからどれだけの時間が進んでいるか、あるいは遅れているかが秒数で返されます。
例えば、日本標準時（JST）はUTCより9時間進んでいます。この場合、日本時間のTimeオブジェクトに対してgmtoffメソッドを呼び出すと、9 * 60 * 60秒、つまり32400が戻り値として得られます。もし、UTCより遅れているタイムゾーンであれば、負の値が返されます。
夏時間（サマータイム）が導入されている地域では、夏時間の期間に応じてUTCからのオフセットが変動することがありますが、gmtoffメソッドは、そのTimeオブジェクトが表す特定の時点での正確なオフセットを返します。
このメソッドは、異なるタイムゾーンで取得された時刻情報を統一的に扱う際や、UTC基準で時刻の差分を計算する必要がある場合に非常に便利です。例えば、ユーザーが指定したタイムゾーンのオフセットを計算したり、システムログのタイムスタンプを分析したりする用途で活用できます。
構文(syntax)
1time_obj = Time.now 2puts time_obj.gmtoff
引数(parameters)
引数なし
引数はありません
戻り値(return)
戻り値なし
戻り値はありません