Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Ruby3.x】DateTime::sec_fraction()メソッドの使い方

sec_fractionメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

sec_fractionメソッドは、DateTimeオブジェクトが保持する秒の小数部分を取得するメソッドです。RubyのDateTimeクラスは、日付と時刻を厳密に扱うためのクラスであり、秒数には整数部分だけでなく、ミリ秒やマイクロ秒、ナノ秒といった小数部分が含まれる場合があります。このメソッドは、DateTimeオブジェクトに設定されている秒未満の精密な時間情報を、Rationalオブジェクトとして取得できます。

Rationalオブジェクトは、分数を誤差なく正確に表現するためのRubyの標準クラスです。そのため、浮動小数点数演算で発生しうる誤差を避けて、例えば0.5秒であれば1/2として、0.25秒であれば1/4として秒の小数部分が返されます。秒の整数部分はsecメソッドで別途取得できるため、DateTimeオブジェクトの完全な秒数はsecメソッドの戻り値とsec_fractionメソッドの戻り値を合計することで正確に計算することが可能です。

このメソッドは、非常に正確な時間計算が求められるシステムや、タイムスタンプの精度を厳密に比較する必要がある場面、高精度なイベントログを記録する際などに特に有用です。初心者の方にとっては、日時データを扱う際に、単に秒を整数として扱うだけでなく、より詳細な時間情報も扱えることを理解する上で重要な役割を果たすでしょう。

構文(syntax)

1require 'date'
2
3datetime_object = DateTime.new(2023, 1, 1, 10, 30, 25.123)
4datetime_object.sec_fraction

引数(parameters)

引数なし

引数はありません

戻り値(return)

Rational

DateTimeオブジェクトが保持する秒の小数部分を、有理数(Rational)で返します。

関連コンテンツ