Java Academy · レッスン

LocalDate、LocalTime、LocalDateTime

Q: 「LocalDate、LocalTime、LocalDateTime」で何を学びますか？

日付と時刻を表現します ブラウザで直接実行するハンズオンコードでJava Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

日付と時刻を表現します

「LocalDate、LocalTime、LocalDateTime」はCoddyKit上の無料Java Academyレッスンです。これはレッスン1/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはJava Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Java Academyコースには全4レッスンが含まれています。

LocalDate

LocalDateは時刻の要素を持たない日付、つまり年、月、日を表します。LocalDate.now()は今日の日付を返しますが、予測可能な出力にするため、テストでは固定の日付を使用してください。

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 5, 30);
        System.out.println(date);
    }
}

日付の各要素を取得する

getYear、getMonthValue、getDayOfMonthを使って各要素を取り出せます。また、便利なgetDayOfWeekも使用できます。

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2026, 5, 30);
        System.out.println(date.getYear());
        System.out.println(date.getMonthValue());
        System.out.println(date.getDayOfWeek());
    }
}

LocalTime

LocalTimeは、日付を持たず、時、分、秒、ナノ秒で構成される時刻を表します。

import java.time.LocalTime;

public class Main {
    public static void main(String[] args) {
        LocalTime time = LocalTime.of(14, 30, 15);
        System.out.println(time);
        System.out.println(time.getHour());
    }
}

LocalDateTime

LocalDateTimeは、日付と時刻を1つの値にまとめたものです。タイムゾーンは付加されません。

import java.time.LocalDateTime;

public class Main {
    public static void main(String[] args) {
        LocalDateTime dt = LocalDateTime.of(2026, 5, 30, 9, 45);
        System.out.println(dt);
    }
}

日付と時刻の組み合わせ

atTimeを使うと、LocalDateとLocalTimeを結合してLocalDateTimeを生成できます。

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

public class Main {
    public static void main(String[] args) {
        LocalDate d = LocalDate.of(2026, 5, 30);
        LocalTime t = LocalTime.of(8, 0);
        LocalDateTime dt = d.atTime(t);
        System.out.println(dt);
    }
}

不変性と with

これらの型は不変です。withYearのようなメソッドは変更後の新しいコピーを返し、元の値は変更しません。

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate original = LocalDate.of(2026, 5, 30);
        LocalDate changed = original.withYear(2030);
        System.out.println(original);
        System.out.println(changed);
    }
}

日付の比較

isBefore、isAfter、isEqualを使うと、時系列上の順序を読みやすい形で比較できます。

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate a = LocalDate.of(2026, 1, 1);
        LocalDate b = LocalDate.of(2026, 12, 31);
        System.out.println(a.isBefore(b));
        System.out.println(a.isAfter(b));
    }
}

便利な問い合わせ

isLeapYearやlengthOfMonthのような便利なメソッドを使うと、よくある確認を簡単に行えます。

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, 2, 1);
        System.out.println(date.isLeapYear());
        System.out.println(date.lengthOfMonth());
    }
}

テキストからの解析

各型では、ISO形式の文字列を解析できます。LocalDate.parseは、2026-05-30のような値を読み取ります。

import java.time.LocalDate;

public class Main {
    public static void main(String[] args) {
        LocalDate date = LocalDate.parse("2026-05-30");
        System.out.println(date.getMonth());
    }
}

適切な型の選択

誕生日やカレンダー上の日付にはLocalDate、営業時間にはLocalTime、日付と時刻を組み合わせた予定にはLocalDateTimeを使います。いずれもタイムゾーンを持ちません。

確認テスト

日付と時刻の基本的な型についての理解度を確認しましょう。

まとめ

日付と時刻を扱う基本的なjava.timeの型について学びました。

日付にはLocalDate、時刻にはLocalTime、日付と時刻の両方にはLocalDateTimeを使います
すべて不変であり、withメソッドは新しいコピーを返します
getYear、getDayOfWeekなどのgetterで各部分を読み取ります
isBeforeとisAfterで比較します
parseでISO文字列を解析します

よくある質問