JavaのLocalDate.atTimeの使い方を完全解説！初心者でもわかる日付と時間の組み合わせ

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

「1. java.timeパッケージとは？」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

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

Javaのjava.timeパッケージは、Java 8から導入された日付や時刻を扱うための標準ライブラリです。これまで使用されていたjava.util.DateやCalendarに代わって、より直感的で安全に日付や時刻を操作できるようになっています。

このパッケージには、LocalDateやLocalTime、LocalDateTime、ZonedDateTimeなど、さまざまなクラスが含まれており、用途に応じて選ぶことができます。

2. LocalDateクラスの基本

2. LocalDateクラスの基本

LocalDateクラスは、日付（年・月・日）のみを表現するクラスです。時間情報は持ちません。例えば、「2025年9月4日」のように、特定の日付だけを扱いたいときに使います。

時間と組み合わせたい場合は、atTimeメソッドを使用してLocalDateTimeに変換します。

以下はLocalDateの基本的な使い方の例です。

import java.time.LocalDate;

public class LocalDateExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        System.out.println("今日の日付: " + today);
    }
}

3. atTimeメソッドとは？

3. atTimeメソッドとは？

LocalDateクラスのatTimeメソッドは、日付に時間を加えてLocalDateTimeオブジェクトを作るためのメソッドです。時間は、時・分・秒を指定できます。

これにより、例えば「2025年9月4日 15時30分00秒」というような日時を簡単に作成できます。

atTimeメソッドにはいくつかのオーバーロード（引数の違いによるバリエーション）があります：

• atTime(int hour, int minute)
• atTime(int hour, int minute, int second)
• atTime(LocalTime time)

4. atTimeメソッドの具体的な使用例

「4. atTimeメソッドの具体的な使用例」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

4. atTimeメソッドの具体的な使用例

それでは、実際にatTimeメソッドを使って日付と時間を結合する方法を見てみましょう。

import java.time.LocalDate;
import java.time.LocalDateTime;

public class AtTimeExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2025, 9, 4);
        LocalDateTime dateTime = date.atTime(15, 30);
        System.out.println("指定日時: " + dateTime);
    }
}

指定日時: 2025-09-04T15:30

このように、LocalDateオブジェクトにatTimeを使って時間を追加すると、LocalDateTimeオブジェクトが生成されます。

5. LocalTimeと組み合わせる方法

5. LocalTimeと組み合わせる方法

LocalTimeを使って、より柔軟にatTimeを活用することもできます。LocalTimeは時間（時・分・秒）のみを表すクラスです。

import java.time.LocalDate;
import java.time.LocalTime;
import java.time.LocalDateTime;

public class AtTimeWithLocalTime {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2025, 9, 4);
        LocalTime time = LocalTime.of(8, 15, 45);
        LocalDateTime dateTime = date.atTime(time);
        System.out.println("結合結果: " + dateTime);
    }
}

結合結果: 2025-09-04T08:15:45

6. 実用例：スケジュール作成やログのタイムスタンプに活用

6. 実用例：スケジュール作成やログのタイムスタンプに活用

LocalDateとatTimeは、日付と時間を一緒に管理するアプリケーションで非常に役立ちます。以下のような場面で活用されています：

• スケジュール帳アプリで予定の日時を管理する
• ログ出力の際に日時情報を記録する
• 予約システムでユーザーが選んだ日時を扱う

日時の操作は業務システムでも頻繁に登場する処理なので、初心者のうちからjava.time.LocalDateやatTimeメソッドの理解はとても大切です。

7. よくある間違いと注意点

「7. よくある間違いと注意点」の重要ポイントを、初心者の方にも分かりやすく簡潔に解説します。

7. よくある間違いと注意点

Java初心者がatTimeを使うときによくある間違いは、次のようなものです：

• 時間の指定が範囲外（例えばatTime(25, 0)など）
• 時間情報が足りないのに引数を省略する
• 間違えてLocalDateとLocalDateを組み合わせようとする

特に、時間の範囲は24時間制で0〜23です。正しく指定しないと例外が発生するため、注意が必要です。

8. Javaの日時操作でLocalDateとatTimeは必須知識！

8. Javaの日時操作でLocalDateとatTimeは必須知識！

LocalDateとatTimeは、Javaで日付と時間を効率よく扱うための基本的かつ重要な機能です。特に初心者がJavaでアプリケーションを開発するとき、日時を扱う場面は必ず出てきます。

今回紹介した使い方をマスターすることで、Javaの日時操作がグッと身近に感じられるようになるでしょう。

これからJavaでの開発を進めるうえで、java.timeパッケージの使い方は欠かせません。ぜひ、手を動かして実際に書いてみてください！