【Ruby3.x】Time::gmtime()メソッドの使い方
gmtimeメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
gmtimeメソッドは、Timeオブジェクトが保持する時刻情報を、協定世界時（UTC）のタイムゾーンで表現した新しいTimeオブジェクトを生成し、それを返すメソッドです。
このメソッドの主な目的は、異なるタイムゾーンで作成されたTimeオブジェクトを、タイムゾーンに依存しない共通の時刻表現に変換することです。例えば、日本標準時（JST）で設定されたTimeオブジェクトにgmtimeメソッドを呼び出すと、時刻の絶対的な瞬間は変わりませんが、そのTimeオブジェクトのタイムゾーンはUTCとして扱われるようになります。これにより、世界中のどの場所でシステムが稼働していても、同じ時刻を同じ表現で扱うことが可能になります。
gmtimeメソッドは、元のTimeオブジェクト自体を変更せず、あくまでタイムゾーンがUTCに設定された新しいTimeオブジェクトを返します。この「非破壊的」な動作は、既存の時刻情報に影響を与えずに、変換後の時刻を利用したい場合に非常に有用です。主に、ログの記録、データベースへの時刻保存、あるいは異なるシステム間で時刻情報をやり取りするAPI連携など、グローバルな環境で時刻を統一的に扱う必要がある場面で利用されます。これにより、タイムゾーンの差異による混乱を防ぎ、システムの正確性を保つことができます。
構文(syntax)
1Time.now.gmtime
引数(parameters)
引数なし
引数はありません
戻り値(return)
Time
指定された時刻を協定世界時（UTC）に変換した新しいTimeオブジェクトを返します。