【Ruby3.x】Date::upto()メソッドの使い方
uptoメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
uptoメソッドは、ある日付から別の日付までの期間を順に処理するために使用するメソッドです。このメソッドは、RubyのDateクラスのインスタンスに対して呼び出され、引数として指定された終了日までの全ての日付を一日ずつ進めながら反復処理を行います。各日付について、渡されたブロック内の処理を実行し、その日付をブロック引数として渡します。
たとえば、特定の日付範囲にわたる日々のデータを集計したり、カレンダーのような日付表示を生成したりする場合に非常に役立ちます。日付の連続したシーケンスを簡単に生成し、それぞれの日に特定の操作を適用できるため、期間ベースの処理を簡潔に記述できます。このメソッドは、開始日から終了日まで（終了日を含む）の全ての日付を対象とします。最終的に、このメソッドは呼び出し元であるDateオブジェクト自身を返します。
構文(syntax)
1require 'date' 2 3Date.today.upto(Date.today + 3) do |date| 4 # date を使った処理 5end
引数(parameters)
max
- max: 繰り返しの終了日を指定するDateオブジェクト
戻り値(return)
Date or Enumerator
指定された条件を満たした説明文を以下に示します。
指定された日付から、指定された増分で生成される日付の列挙子、または指定された終端日付に達するまで生成された日付の配列を返します。