【Ruby3.x】Time::local()メソッドの使い方
localメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
localメソッドは、指定された年、月、日、時、分、秒などの日時情報に基づいて、新しいTimeオブジェクトを生成するメソッドです。このメソッドは、プログラムが実行されているシステムのローカルタイムゾーン（地域時間）を基準として日時を解釈し、対応するTimeオブジェクトを作成します。
引数には、Time.local(年, 月, 日, 時, 分, 秒)のように、日時要素を順番に指定します。例えば、Time.local(2023, 10, 27, 10, 30, 0)と記述すると、2023年10月27日の午前10時30分0秒を、システムのローカルタイムゾーンで表すTimeオブジェクトが生成されます。引数は一部を省略することも可能で、省略された場合、秒は0、分は0、時は0、日は1、月は1、年は現在の年といったデフォルト値が適用されます。
このメソッドは、特定の地域における特定の日時を扱う際に利用され、システムのタイムゾーン設定に合わせた時間オブジェクトを生成したい場合に非常に便利です。これにより、開発者はタイムゾーンの詳細を深く意識することなく、直感的に日付と時刻を表現・操作できます。
構文(syntax)
1Time.local(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, nanosec = nil
- year: 指定する西暦年 (整数)
- month = nil: 指定する月 (1から12の整数、省略可)
- day = nil: 指定する日 (1から31の整数、省略可)
- hour = nil: 指定する時 (0から23の整数、省略可)
- min = nil: 指定する分 (0から59の整数、省略可)
- sec = nil: 指定する秒 (0から59の整数、省略可)
- nanosec = nil: 指定するナノ秒 (0から999,999,999の整数、省略可)
戻り値(return)
Time
現在時刻を、ローカルタイムゾーンで表したTimeオブジェクトを返します。