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

next_yearメソッドは、Dateオブジェクトに対して、指定された年数後の日付を表す新しいDateオブジェクトを生成して返すメソッドです。

このメソッドはオプションで years という整数型の引数を受け取ります。years を省略した場合、デフォルト値として 1 が適用され、元のDateオブジェクトが表す日付のちょうど1年後の日付が計算されます。例えば、Date.new(2023, 10, 26) という日付オブジェクトに対して next_year を呼び出すと、Date.new(2024, 10, 26) という新しい日付オブジェクトが返されます。

引数 years に 2 を指定すれば2年後の日付が、-1 を指定すれば1年前の日付が返されるなど、任意の年数を加算または減算して日付を計算することが可能です。このメソッドの重要な点として、呼び出し元のDateオブジェクト自体は変更されず、常に新しいDateオブジェクトが生成されて戻り値として提供されます。これは、プログラム内で日付の値を不変に保ちたい場合に非常に有用です。

契約の更新日や記念日など、特定の日付から将来または過去の同月同日の日付を簡単かつ安全に求めるための、Dateクラスが提供する便利な機能の一つです。

Copy
1require 'date'
2
3current_date = Date.today
4one_year_later = current_date.next_year

引数なし

引数はありません

Date

指定されたDateオブジェクトの年を1つ進めた、新しいDateオブジェクトを返します。