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

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

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

作成日: 更新日:

基本的な使い方

yearメソッドは、Dateオブジェクトが保持する日付情報から、その年を表す整数を取得するメソッドです。

このメソッドは、RubyのDateクラスのインスタンスに対して呼び出され、引数を一切取りません。呼び出されたDateオブジェクトが表す日付の年を数値として返します。例えば、Date.new(2023, 10, 26)という日付オブジェクトが存在するとします。このオブジェクトに対してyearメソッドを呼び出すと、2023という整数値が戻り値として得られます。これにより、特定の日付がどの年に属しているかを簡潔かつ正確に把握することができます。

システム開発において、日付に関連する処理は頻繁に発生します。例えば、ある年のデータを集計したり、特定の年に関するレポートを作成したり、または特定の年のイベントを抽出したりする場合などです。yearメソッドは、このような場面で日付オブジェクトから「年」の情報のみを効率的に抽出するために利用される、基本的ながら非常に重要なメソッドの一つです。日付の年成分だけを必要とする際に、このメソッドを使用することで、コードの可読性と保守性を高めることができます。

構文(syntax)

1require 'date'
2
3date_object = Date.new(2023, 1, 1)
4year = date_object.year

引数(parameters)

引数なし

引数はありません

戻り値(return)

Integer

Dateオブジェクトが表す日付の年を整数で返します。

関連コンテンツ

関連プログラミング言語