【Ruby3.x】Time::year()メソッドの使い方
yearメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
yearメソッドは、RubyのTimeクラスのインスタンスに対して呼び出され、そのTimeオブジェクトが表す日付の「年」の部分を整数として取得するメソッドです。このメソッドを使用することで、特定の時刻情報から年だけを簡単に取り出すことができます。
Timeオブジェクトは、特定の日付と時刻の瞬間を保持しており、その情報の中から「年」という要素だけが必要な場合にyearメソッドが役立ちます。例えば、Time.new(2023, 10, 26, 15, 30, 0)のようにして作成された「2023年10月26日 午後3時30分」という時刻を表すTimeオブジェクトがあったとします。このオブジェクトに対してyearメソッドを呼び出すと、2023という整数値が戻り値として得られます。
このメソッドは引数を取る必要がなく、Timeオブジェクトのインスタンスに続けて.yearと記述するだけで利用可能です。日付や時刻を扱うアプリケーション開発において、特定の年のデータを抽出したり、表示する年を決定したりする際など、多様な場面で年情報を直感的かつ簡潔に取得するために利用されます。開発者が日付に関する処理を記述する際に、標準的で信頼性の高い方法として提供されています。
構文(syntax)
1time_object.year
引数(parameters)
引数なし
引数はありません
戻り値(return)
Integer
指定されたTimeオブジェクトが表す日付の年を整数で返します。