【Ruby3.x】Time::gm()メソッドの使い方
gmメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
gmメソッドは、RubyのTimeクラスに属し、UTC（協定世界時）に基づいた新しいTimeオブジェクトを生成するメソッドです。このメソッドはTime.utcメソッドの別名であり、両者はまったく同じ機能を提供します。
引数には、年、月、日、時、分、秒、マイクロ秒（またはミリ秒）を整数で指定することができます。これらの引数はすべてUTCでの日時として解釈され、指定された値に基づいてTimeオブジェクトが作成されます。例えば、Time.gm(2023, 10, 27, 10, 30, 0)と記述すると、2023年10月27日10時30分0秒のUTC時刻を表すTimeオブジェクトが生成されます。引数を省略した場合、月と日は1日、時、分、秒は0と見なされます。
Time.newやTime.localがシステムのタイムゾーン設定に依存して時刻を生成するのに対し、gmメソッドは常にタイムゾーンの影響を受けないUTC時刻を扱います。これにより、異なる地域やシステム間で時刻を統一的に管理する必要がある場合や、タイムゾーンの変更に影響されない正確な時刻を記録する場合に非常に有効です。特に、国際的なアプリケーション開発やログのタイムスタンプ記録など、時刻のずれによる問題を避けるために活用されます。
構文(syntax)
1Time.gm(year, month=nil, day=nil, hour=nil, min=nil, sec=nil, usec=nil)
引数(parameters)
year, month = nil, day = nil, hour = nil, min = nil, sec = nil, usec = nil
- year: 年を指定する整数
- month: 月を指定する整数 (省略可能)
- day: 日を指定する整数 (省略可能)
- hour: 時を指定する整数 (省略可能)
- min: 分を指定する整数 (省略可能)
- sec: 秒を指定する整数 (省略可能)
- usec: マイクロ秒を指定する整数 (省略可能)
戻り値(return)
Time
gm メソッドは、Time オブジェクトを UTC (協定世界時) で表現した新しい Time オブジェクトを返します。