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との組み合わせを理解すれば、日時処理の基本をマスターできます。
まとめ
LocalDateTimeとplusメソッドの重要ポイント総整理
Javaにおける日時処理は、業務システムやWebアプリケーション開発において非常に重要な要素のひとつです。その中でもjava.timeパッケージに含まれるLocalDateTimeクラスとplusメソッドは、未来や過去の日時を正確かつ安全に扱うための基本的な機能として、多くの現場で活用されています。
LocalDateTimeは日付と時刻を同時に扱える便利なクラスであり、現在日時の取得から、時間の加算や減算まで幅広く対応できます。特にplusメソッドを使うことで、現在時刻から一時間後や一日後といった未来の日時を簡単に計算できるため、予約システムや期限管理などで非常に役立ちます。
plusメソッドの仕組みと活用の考え方
plusメソッドは、日時に対して指定した単位の時間を加算するためのメソッドです。plusDaysやplusHoursなどの専用メソッドを使うことで直感的に日時計算ができ、コードの可読性も高くなります。また、ChronoUnitと組み合わせることで、より柔軟な時間操作が可能になります。
例えば数秒後や数週間後といった細かい指定もできるため、実務におけるスケジュール管理やイベント処理において欠かせない存在となっています。
実務で使われる日時計算のサンプルコード
import java.time.LocalDateTime;
import java.time.temporal.ChronoUnit;
public class ScheduleService {
public static void main(String[] args) {
LocalDateTime now = LocalDateTime.now();
LocalDateTime deadline = now.plusDays(7);
LocalDateTime meetingTime = now.plusHours(2);
LocalDateTime shortTask = now.plus(15, ChronoUnit.MINUTES);
System.out.println("現在: " + now);
System.out.println("締切: " + deadline);
System.out.println("会議: " + meetingTime);
System.out.println("作業終了予定: " + shortTask);
}
}
このように、LocalDateTimeとplusメソッドを組み合わせることで、業務で必要となる日時計算を簡単に実装できます。コードの見通しも良く、メンテナンス性も高い点が大きなメリットです。
イミュータブル設計の理解が重要
LocalDateTimeはイミュータブルなクラスであるため、plusメソッドを実行しても元のオブジェクトは変更されません。常に新しいインスタンスが生成されるため、元の値を保持したまま別の日時を扱うことができます。
この設計により、意図しないデータ変更を防ぎ、安全なプログラムを書くことができます。初心者のうちからこの考え方を理解しておくことは非常に重要です。
LocalDateやLocalTimeとの使い分け
日付のみを扱う場合はLocalDate、時間のみを扱う場合はLocalTimeを使用し、日付と時間の両方を扱う場合はLocalDateTimeを使用するという使い分けが重要です。用途に応じて適切なクラスを選択することで、よりシンプルで分かりやすいコードを書くことができます。
日時処理で意識すべきポイント
- LocalDateTimeは日付と時刻を同時に扱える
- plusメソッドで未来の日時を簡単に計算できる
- ChronoUnitと組み合わせると柔軟な操作が可能
- イミュータブル設計で安全に扱える
- 用途に応じてLocalDateやLocalTimeを使い分ける
このようにLocalDateTimeとplusメソッドは、Javaの日時処理の基礎でありながら非常に強力な機能です。しっかり理解して使いこなすことで、実務でも通用する安定したコードを書くことができるようになります。
生徒
「LocalDateTimeとplusメソッドで未来の日時が簡単に計算できるようになりました。」
先生
「日時処理の基本としてとても重要な知識です。」
生徒
「ChronoUnitを使うともっと柔軟に書けるのも理解できました。」
先生
「細かい時間指定ができるので実務で役立ちます。」
生徒
「イミュータブルという考え方も初めて知りました。」
先生
「安全なコードを書くための重要な概念です。」
生徒
「LocalDateやLocalTimeとの違いも理解できました。」
先生
「用途に応じた使い分けを意識しましょう。」
生徒
「実務でも使えるように練習していきます。」
先生
「ぜひ日常的に使って身につけてください。」