【Ruby3.x】Time::floor()メソッドの使い方
floorメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
floorメソッドは、Timeクラスに属し、特定の基準で時刻情報を切り捨てる（床関数のように下へ丸める）メソッドです。
このメソッドは、呼び出し元のTimeオブジェクトが保持する日付と時刻の情報から、指定された秒数未満の部分を切り捨て、新しいTimeオブジェクトを生成します。元のTimeオブジェクトは変更されません。
引数に秒数（例えば整数値）を指定することで、その秒数の倍数で時刻を丸めることができます。例えば、引数に60を指定すると、分以下の秒数（秒、ミリ秒、マイクロ秒、ナノ秒）が切り捨てられ、最も近い「00秒」の区切り（例: HH:MM:00）に時刻が丸められます。同様に、3600を指定すれば時以下の部分が、86400を指定すれば日以下の部分が切り捨てられます。
引数を省略した場合、デフォルトで1秒が使用されます。この場合、マイクロ秒やナノ秒といった秒未満の情報が切り捨てられ、秒単位で丸められた時刻が得られます。
この機能は、ログのタイムスタンプを一定の間隔で揃えたり、特定の時間間隔でデータを集計したりする際に、時間データを正規化する目的で活用されます。システム開発において、時間に基づくデータ処理の精度を調整する場面で役立ちます。
構文(syntax)
1Time.now.floor
引数(parameters)
ndigits = 0
- ndigits = 0: 秒の小数点以下の桁数を指定する整数。0を指定すると、整数秒に丸められます。
戻り値(return)
Time
指定された秒数で切り捨てられた新しいTimeオブジェクトを返します。