【Ruby3.x】Time::month()メソッドの使い方
monthメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
monthメソッドは、Timeオブジェクトが保持する日付情報から、その月の部分を数値として取得するメソッドです。Ruby 3の組み込み機能として提供されており、Timeクラスのインスタンスに対して呼び出します。
このメソッドは引数を一切取らず、呼び出し元のTimeオブジェクトが示す日付の月を整数値で返します。戻り値の範囲は、1月から12月までの間に対応する1から12の数値です。例えば、現在時刻を表すTime.nowというオブジェクトを作成し、それに対してmonthメソッドを呼び出すと、現在の月が数値で得られます。具体的には、Time.new(2023, 10, 26, 10, 30, 0)というTimeオブジェクトがある場合、time_object.monthと記述することで、数値の10が返されます。
monthメソッドは、特定の日付が何月であるかをプログラムで確認したい場合や、月の値に基づいて条件分岐の処理を行いたい場合などに非常に便利です。例えば、ユーザーが入力した日付やデータベースから取得した日付の月を判定して、特定の月のイベントデータだけを抽出する、または月ごとに異なるレポートを生成するなどの処理に利用できます。このように、日付と時刻を扱うプログラムにおいて、特定の月の情報に簡潔にアクセスするための基本的な手段として、幅広く活用されています。
構文(syntax)
1time_object.month
引数(parameters)
引数なし
引数はありません
戻り値(return)
integer
Timeオブジェクトが表す日付の月を表す整数を返します。例えば、1月であれば1、12月であれば12が返されます。