【Ruby3.x】Time::getgm()メソッドの使い方
getgmメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
getgmメソッドは、Timeオブジェクトが保持する時刻を協定世界時（UTC）として表現する新しいTimeオブジェクトを生成するメソッドです。このメソッドは、呼び出し元のTimeオブジェクトが内部的に持つ時刻値（例えば、UNIXエポックからの経過秒数）自体を変更することはありません。代わりに、その時刻がどのタイムゾーンで解釈されるかという情報だけを協定世界時に設定し、その設定が反映された新しいTimeオブジェクトを返します。
具体的には、日本標準時（JST）などのローカルタイムで作成されたTimeオブジェクトに対してgetgmメソッドを適用すると、元の時刻値はそのままに、タイムゾーン情報だけがUTCに変更された新しいTimeオブジェクトが得られます。これにより、世界中のどこでも共通の基準となる時刻であるUTCで、特定の時間を表現することが可能になります。
getgmメソッドは、異なるタイムゾーンで動作するシステム間で時刻データを交換する際や、データベースに時刻を保存する際に一貫性を保つために非常に有用です。例えば、複数のタイムゾーンにまたがるユーザーが関わるアプリケーションで、イベント発生時刻をUTCで記録しておけば、すべてのユーザーに対して正確な時刻情報を提供できます。元のTimeオブジェクトが変更されることはなく、常に新しいTimeオブジェクトが生成されるため、安全に利用できます。この機能は、グローバルなアプリケーション開発において、時刻の正確性と一貫性を確保するために不可欠な要素です。
構文(syntax)
1Time.now.getgm
引数(parameters)
引数なし
引数はありません
戻り値(return)
Time
UTC（協定世界時）での現在時刻を表す新しいTimeオブジェクトを返します。