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

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

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

作成日: 更新日:

基本的な使い方

ydayメソッドは、指定された日付がその年の何日目であるかを示す整数を返すメソッドです。このメソッドはRubyのDateクラスに属しており、Dateオブジェクトのインスタンスに対して呼び出すことで利用できます。

具体的には、対象となるDateオブジェクトが表す日付が、その年の1月1日から数えて何日目に当たるかを計算し、その結果を整数値で返します。たとえば、1月1日の日付に対してydayメソッドを呼び出すと「1」が返され、1月2日であれば「2」が返されます。2月1日であれば、1月の日数(31日)に2月1日を加えた「32」が返されることになります。

この計算では、対象となる年が閏年(うるうどし)であるかどうかも自動的に考慮されます。そのため、閏年の2月29日は年内の60日目として正しく計算され、2月29日以降の日付についても正確な年内日数を取得することができます。

ydayメソッドは、ある日付が年末まであと何日残っているかを計算する際や、年間の日付データの中から特定の時期のデータを抽出・分析する際など、日付に関連する処理において非常に役立つ機能を提供します。

構文(syntax)

1require 'date'
2
3date = Date.new(2023, 1, 31)
4puts date.yday

引数(parameters)

引数なし

引数はありません

戻り値(return)

Integer

Dateオブジェクトが表す年の1月1日からの通算日数を整数で返します。

関連コンテンツ

関連プログラミング言語