JavaのLocalDateTimeクラスのplusメソッドを徹底解説!初心者向け時間操作ガイド
生徒
「先生、Javaで現在の日時から一日後や一時間後の日時を計算したいときってどうすればいいんですか?」
先生
「Javaにはjava.timeパッケージがあり、その中のLocalDateTimeクラスを使うと簡単に日時を扱うことができます。そして日時を加算する場合にはplusメソッドが便利なんですよ。」
生徒
「なるほど!具体的にはどんな使い方になるんですか?」
先生
「それでは基本的な例から一緒に見ていきましょう。」
1. java.timeパッケージとは?
Javaのjava.timeパッケージは、日時や期間を扱うための最新のAPI群です。Java8で導入され、従来のDateやCalendarよりも直感的で使いやすく、タイムゾーンや日付計算も安全に行えるようになっています。初心者が日時処理を学ぶときにまず覚えるべきのが、このパッケージに含まれるLocalDateTimeクラスです。
2. LocalDateTimeクラスとは?
LocalDateTimeクラスは、日付(年月日)と時刻(時分秒ナノ秒)をまとめて表すクラスです。名前の通り「ローカルな日付と時間」を扱い、タイムゾーン情報は含みません。現在の日時を取得したり、過去や未来の日時を計算したりするのに使われます。
import java.time.LocalDateTime;
public class LocalDateTimeExample {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
System.out.println("現在の日時: " + now);
}
}
3. plusメソッドの基本
plusメソッドは、LocalDateTimeに対して日時を加算するためのメソッドです。例えば「1日後」「3時間後」「2分後」といった未来の日時を求めることができます。引数にDurationやPeriodを渡して細かい指定を行うことも可能です。
import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;
public class PlusMethodExample {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
LocalDateTime tomorrow = now.plusDays(1);
LocalDateTime nextHour = now.plusHours(1);
LocalDateTime nextMinute = now.plusMinutes(30);
System.out.println("現在: " + now);
System.out.println("1日後: " + tomorrow);
System.out.println("1時間後: " + nextHour);
System.out.println("30分後: " + nextMinute);
}
}
4. 実行結果の例
実際に上記プログラムを実行すると、次のように現在時刻を基準とした未来の日時が出力されます。
現在: 2025-09-23T14:35:12.345
1日後: 2025-09-24T14:35:12.345
1時間後: 2025-09-23T15:35:12.345
30分後: 2025-09-23T15:05:12.345
5. plusメソッドのバリエーション
LocalDateTimeのplusメソッドには、plusDaysやplusHoursなどのショートカットメソッドが多数用意されています。また、より柔軟に使いたい場合にはplus(long amountToAdd, TemporalUnit unit)を利用します。これにより「10秒後」や「2週間後」といった幅広い計算が可能です。
import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;
public class PlusVariationExample {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
LocalDateTime after10Seconds = now.plus(10, ChronoUnit.SECONDS);
LocalDateTime after2Weeks = now.plus(2, ChronoUnit.WEEKS);
System.out.println("現在: " + now);
System.out.println("10秒後: " + after10Seconds);
System.out.println("2週間後: " + after2Weeks);
}
}
6. 日付計算での注意点
日時の加算を行うときには、元のLocalDateTimeオブジェクトが変更されるわけではなく、新しいオブジェクトが返されることに注意しましょう。これはイミュータブル(不変)な設計になっているためです。元の日時を保持しつつ新しい日時を生成できるので、安心して計算処理に使うことができます。
7. plusメソッドの活用シーン
実際の開発では、イベントのスケジュール計算や予約システム、期限管理などでplusメソッドが頻繁に活用されます。例えば「現在から7日後の締め切り日を計算する」「現在の時間から90分後の終了時刻を求める」といった処理に役立ちます。初心者でも直感的に理解できる構文なので、業務システムでも広く使われています。
8. ChronoUnitとの組み合わせ
ChronoUnitは、秒・分・時・日・週・月・年といった時間単位を表現する列挙型です。plusメソッドと組み合わせることで、柔軟かつ読みやすいコードを書くことができます。
import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;
public class ChronoUnitExample {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
LocalDateTime nextMonth = now.plus(1, ChronoUnit.MONTHS);
LocalDateTime nextYear = now.plus(1, ChronoUnit.YEARS);
System.out.println("現在: " + now);
System.out.println("1か月後: " + nextMonth);
System.out.println("1年後: " + nextYear);
}
}
9. LocalDateやLocalTimeとの違い
LocalDateTimeは日付と時刻を両方扱えるのに対し、LocalDateは日付のみ、LocalTimeは時刻のみを扱います。それぞれの用途に応じて使い分けることが重要です。日付だけの加算ならLocalDateのplusDaysを、時間だけならLocalTimeのplusHoursを活用できます。
10. 覚えておきたいポイント
初心者が日時処理を学ぶ際には、まずjava.timeパッケージを使う習慣をつけましょう。その中でもLocalDateTimeとplusメソッドは、未来の日時を求める場面で非常に役立ちます。イミュータブル設計やChronoUnitとの組み合わせを理解すれば、日時処理の基本をマスターできます。