【Ruby3.x】Time::at()メソッドの使い方
atメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
atメソッドは、特定の時点を表すタイムスタンプの数値から、Timeオブジェクトを生成するメソッドです。主に、1970年1月1日UTCからの経過秒数であるUnixタイムスタンプの数値を、Rubyで扱えるTimeオブジェクトに変換する際に利用されます。
このメソッドの最も一般的な使い方は、一つの数値引数を受け取る形式です。この数値は、整数または浮動小数点数で指定でき、これにより秒単位だけでなく、ミリ秒やマイクロ秒といったより細かい時間単位まで表現することが可能です。例えば、Time.at(1678886400)のように指定すると、そのタイムスタンプに対応するTimeオブジェクトが返されます。
また、atメソッドは、二つの引数を受け取る形式も提供しています。この場合、最初の引数で秒数を、二番目の引数でマイクロ秒またはナノ秒（追加のシンボル引数で指定）を指定できます。これにより、非常に高精度な時刻情報を表現する必要がある場合にも対応できます。
システムエンジニアがデータベースや外部APIと連携する際、時刻情報が数値形式のタイムスタンプとして扱われることがよくあります。atメソッドを使用することで、これらの数値をRubyのTimeオブジェクトに簡単に変換し、日付の計算やフォーマットといった操作を直感的に行えるようになります。これは、システムのログ解析やデータ処理において、非常に便利な機能です。
構文(syntax)
1Time.at(1672531200)
引数(parameters)
seconds_since_epoch, frac = 0, unit = :nanosecond
- seconds_since_epoch: エポック秒（1970年1月1日 00:00:00 UTCからの経過秒数）を表す数値
- frac = 0: 秒の小数部分を指定する数値（デフォルトは0）
- unit = :nanosecond: 時間の単位を指定するシンボル（デフォルトは:nanosecond、例: :second, :millisecond, :microsecond, :nanosecond）
戻り値(return)
Time
指定された秒数を元に、新しいTimeオブジェクトを生成します。