【Ruby3.x】Time::yday()メソッドの使い方
ydayメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
ydayメソッドは、Timeオブジェクトが表す日付が、その年の1月1日から数えて何日目であるかを整数で取得するメソッドです。RubyのTimeクラスは、特定の日付と時刻を扱うためのクラスであり、このydayメソッドはそのTimeオブジェクトが指し示す日付が、その年の何日目にあたるのかを判別する際に使用されます。
具体的には、1月1日をその年の「1日目」として数え始め、年が進むごとに日数を加算していきます。例えば、2023年1月1日のTimeオブジェクトに対してydayメソッドを呼び出すと「1」を返します。また、2023年2月1日のTimeオブジェクトでは「32」を、2023年3月1日のTimeオブジェクトでは「60」（平年であれば59）を返します。うるう年の場合でも同様に、その年の1月1日から数えた通算の日数を正確に返します。
戻り値は、1から365（うるう年の場合は366）の範囲の整数となります。このメソッドは、特定の日付が年間でどの位置にあるかを把握したい場合や、年間を通じたデータ集計、特定の記念日が年に何日目にあたるかなどを計算したい場面で非常に役立ちます。日付の順序や経過日数を基準とした処理を実装する際に、このydayメソッドを活用できます。
構文(syntax)
1Time.now.yday
引数(parameters)
引数なし
引数はありません
戻り値(return)
Integer
その年の1月1日からの経過日数を整数で返します。