Java の LocalDate plusYears メソッド

はじめに

Java の plusYears() メソッドは、指定された LocalDate オブジェクトに一定期間の年数を加え、加算された年数を持つ日付オブジェクトのコピーを返します。

Java 開発環境のセットアップ

Java プログラミングを始めるには、ローカル マシンに Java 開発キット (JDK) をインストールする必要があります。既にインストールされているかどうかを確認するには、次のコマンドを実行します。

java -version

JDK がインストールされていない場合は、公式 Java ウェブサイトからダウンロードして、インストール手順に従ってください。

Java クラス ファイルを作成する

好きなテキスト エディタを使って、~/project ディレクトリに LocalDateDemo.java という名前の Java クラス ファイルを作成します。

touch ~/project/LocalDateDemo.java

必要なパッケージをインポートする

LocalDate クラスとそのメソッドを使用するには、java.time.LocalDate パッケージをインポートする必要があります。

import java.time.LocalDate;

LocalDate オブジェクトを作成する

クラスの of() メソッドを使用して LocalDate オブジェクトを作成し、日付を設定します。

LocalDate date = LocalDate.of(2021, 10, 01);

plusYears() メソッドを使用して日付に年を加える

plusYears() メソッドを使用して、日付オブジェクトに一定の年数を加えます。この例では、日付に 2 年を加えています。

LocalDate newDate = date.plusYears(2);

元の LocalDate オブジェクトと新しいオブジェクトを表示する

最後に、元の LocalDate オブジェクトと年を加えた後の新しい LocalDate オブジェクトを表示します。表示用に日付オブジェクトを文字列に変換するために toString() メソッドを使用します。

System.out.println("Original Date: " + date.toString());
System.out.println("New Date: " + newDate.toString());

うるう年を確認する

次に、うるう年用の LocalDate オブジェクトを作成し、plusYears() メソッドを使用してそれに 1 年を加えてみます。

LocalDate leapDate = LocalDate.of(2020, 02, 29);
LocalDate leapNewDate = leapDate.plusYears(1);

元のうるう年の日付オブジェクトと新しいオブジェクトを表示する

最後に、元のうるう年の日付オブジェクトと年を加えた後の新しいうるう年のオブジェクトを表示します。結果の日付が無効なので、plusYears() メソッドはそれを月の最後の有効な日付、すなわち 2 月 28 日に調整します。

System.out.println("Original Leap Date: " + leapDate.toString());
System.out.println("New Leap Date: " + leapNewDate.toString());

プログラムをコンパイルして実行する

次のコマンドを使用して LocalDateDemo.java ファイルをコンパイルします。

javac LocalDateDemo.java

次のコマンドを使用してプログラムを実行します。

java LocalDateDemo

まとめ

Java の plusYears() メソッドは、LocalDate オブジェクトに特定の年数を加え、加えた年数の新しい日付オブジェクトを返すために使用されます。結果の日付が無効になる場合、このメソッドは日付オブジェクトを調整します。この実験では、plusYears() メソッドを使用して LocalDate オブジェクトに年を加える方法と、その方法を使用してうるう年の日付オブジェクトを処理する方法を示しました。