【Ruby3.x】Time::eql?()メソッドの使い方
eql?メソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
eql?メソッドは、二つのTimeオブジェクトが完全に同じ時刻を表しているかどうかを厳密に比較し、その結果を真偽値で返すメソッドです。このメソッドは、単に時刻の値が同じであるだけでなく、ナノ秒までの精度、さらにはタイムゾーンオフセット（UTCからの時差）といった、Timeオブジェクトが持つすべての内部情報が一致するかどうかを確認します。
通常の==（等価）メソッドも時刻の比較に用いられますが、eql?メソッドはそれよりも厳密な基準で等価性を判断します。例えば、見た目の時刻が同じであっても、片方がマイクロ秒の桁まで異なる値を持っていたり、タイムゾーンのオフセットが異なっていたりすると、eql?メソッドはfalseを返します。
この厳密な比較は、特にTimeオブジェクトをHash（ハッシュ）のキーとして使用する際に重要となります。Hashはキーの等価性を判断するためにeql?メソッドとhashメソッドを利用するため、eql?メソッドがtrueを返すと、それらのTimeオブジェクトはHash内で同じキーとして扱われます。これにより、キーとして利用されるオブジェクトが正確に識別され、意図しない衝突や不一致を防ぐことができます。システムにおいて、時刻情報をキーとする厳密なデータ管理が必要な場面で活用されるメソッドです。
構文(syntax)
1Time.now.eql?(Time.now)
引数(parameters)
other
- other: 比較対象の Time オブジェクト
戻り値(return)
Boolean
与えられたTimeオブジェクトが、別のTimeオブジェクトと時間、分、秒、ナノ秒、タイムゾーンなどが完全に一致する場合に true を、それ以外の場合に false を返します。