JavaのLocalDateTimeクラスとplusHoursメソッドを完全ガイド！初心者でもわかる時間操作

1. java.timeパッケージとは？

1. java.timeパッケージとは？

Javaのjava.timeパッケージは、日付や時間を安全かつ直感的に扱うために導入されたライブラリです。従来のDateやCalendarに比べてコードが読みやすく、バグを減らしやすいのが特徴です。特に初心者が混乱しがちな時間計算もシンプルに記述できるため、システム開発で幅広く利用されています。

2. LocalDateTimeクラスの基本

2. LocalDateTimeクラスの基本

LocalDateTimeクラスは年月日と時刻を同時に表現できる便利なクラスです。例えば「2025年9月23日 14時45分」といった日時をひとつのオブジェクトで扱えます。タイムゾーン情報を持たないため、シンプルに日付や時間を操作したいときに適しています。

import java.time.LocalDateTime;

public class DateTimeNowExample {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        System.out.println("現在の日時: " + now);
    }
}

現在の日時: 2025-09-23T14:45:30.123

3. plusHoursメソッドの使い方

3. plusHoursメソッドの使い方

plusHoursメソッドは現在のLocalDateTimeから指定した時間を加算して新しい日時を返します。元のインスタンスは変更されず、新しい値を生成する「不変オブジェクト」の設計になっている点が重要です。

import java.time.LocalDateTime;

public class PlusHoursExample {
    public static void main(String[] args) {
        LocalDateTime now = LocalDateTime.now();
        LocalDateTime threeHoursLater = now.plusHours(3);
        System.out.println("現在の日時: " + now);
        System.out.println("三時間後の日時: " + threeHoursLater);
    }
}

現在の日時: 2025-09-23T14:45:30.123
三時間後の日時: 2025-09-23T17:45:30.123

4. マイナス値を指定して過去の時間を取得

4. マイナス値を指定して過去の時間を取得

plusHoursは加算だけでなく、マイナスの値を指定することで過去の時間を求めることもできます。例えばplusHours(-5)とすれば、五時間前の時刻を簡単に求められます。ログの調査や過去データの参照時に便利です。

LocalDateTime fiveHoursAgo = LocalDateTime.now().plusHours(-5);
System.out.println("五時間前の日時: " + fiveHoursAgo);

5. plusHoursを使う場面

5. plusHoursを使う場面

業務システムやWebアプリケーションでは、特定の時間後を計算する場面が頻繁にあります。例えば以下のようなケースです。

• 会議開始の三時間前にリマインド通知を送る
• 予約システムで「二時間後から利用可能」と表示する
• バッチ処理の実行予定時刻を数時間後に設定する

これらはいずれもplusHoursを使うことで簡単に実現できます。

6. LocalDateTimeと他の時間クラスの違い

6. LocalDateTimeと他の時間クラスの違い

初心者が混乱しやすいのはLocalTimeとの違いです。LocalTimeは時刻だけを扱うのに対し、LocalDateTimeは日付も一緒に保持します。そのため「三時間後が次の日にまたがる場合」でもLocalDateTimeなら正しく計算できます。

7. plusHoursを安全に使うための注意点

7. plusHoursを安全に使うための注意点

plusHoursを使うときは次の点に注意が必要です。

• 必ず戻り値を新しい変数に代入しないと結果が反映されない
• タイムゾーンを伴う計算が必要な場合はZonedDateTimeを利用する
• マイナスを指定すると過去になるので、意図しない計算にならないように確認する

8. 実践的なサンプルコード

8. 実践的なサンプルコード

例えば、ユーザーがシステムにログインしてから二時間後に自動ログアウトさせたい場合には以下のように書けます。

import java.time.LocalDateTime;

public class AutoLogoutExample {
    public static void main(String[] args) {
        LocalDateTime loginTime = LocalDateTime.now();
        LocalDateTime logoutTime = loginTime.plusHours(2);
        System.out.println("ログイン時刻: " + loginTime);
        System.out.println("自動ログアウト時刻: " + logoutTime);
    }
}

ログイン時刻: 2025-09-23T14:45:30.123
自動ログアウト時刻: 2025-09-23T16:45:30.123

9. plusHoursとシステム開発での応用

9. plusHoursとシステム開発での応用

例えば、配達アプリで「現在時刻から四時間後に到着予定」を表示したり、オンラインゲームで「一定時間後にイベントを開始する」といった処理を組み込むことも可能です。こうした現実的なユースケースを考えると、plusHoursが持つ利便性が理解しやすいでしょう。