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

Javaのjava.timeパッケージは、日付と時間を扱うための新しいAPIで、Java8から導入されました。従来のjava.util.DateやCalendarに比べて、コードが読みやすく、安全に設計されています。

このパッケージには、LocalDate・LocalTime・LocalDateTimeなど、目的に応じて使い分けられる便利なクラスが多数用意されています。中でも、LocalDateは時間を含まない日付を表すのに最適です。

2. LocalDateクラスの基本

LocalDateクラスは、年月日だけを扱うシンプルな日付クラスです。時間の概念が不要な場合に便利で、「2025年9月4日」といった形式の日付を扱います。

例えば、今日の日付を取得するには以下のように記述します。


import java.time.LocalDate;

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

3. withメソッドとは？

withメソッドは、LocalDateクラスに用意されている日付操作メソッドの一つで、年・月・日など、特定の値だけを変更した新しいLocalDateインスタンスを返します。

このメソッドは、元の日付を変更するのではなく、新たなオブジェクトを返す不変（イミュータブル）設計になっており、安全な日付処理ができます。

4. withメソッドで年・月・日を変更する

以下のサンプルでは、日付の年・月・日をwithメソッドで個別に変更しています。


import java.time.LocalDate;

public class WithExample {
    public static void main(String[] args) {
        LocalDate original = LocalDate.of(2023, 5, 15);
        LocalDate changedYear = original.withYear(2025);
        LocalDate changedMonth = original.withMonth(12);
        LocalDate changedDay = original.withDayOfMonth(1);

        System.out.println("元の日付：" + original);
        System.out.println("年だけ変更：" + changedYear);
        System.out.println("月だけ変更：" + changedMonth);
        System.out.println("日だけ変更：" + changedDay);
    }
}


元の日付：2023-05-15
年だけ変更：2025-05-15
月だけ変更：2023-12-15
日だけ変更：2023-05-01

このように、withYear・withMonth・withDayOfMonthを使えば、必要な部分だけを柔軟に変更できます。

5. TemporalFieldを使った応用的な変更

withメソッドは、ChronoFieldなどのTemporalFieldを使って柔軟な指定もできます。


import java.time.LocalDate;
import java.time.temporal.ChronoField;

public class TemporalWithExample {
    public static void main(String[] args) {
        LocalDate date = LocalDate.of(2024, 8, 10);
        LocalDate updated = date.with(ChronoField.MONTH_OF_YEAR, 2);
        System.out.println("月を2月に変更：" + updated);
    }
}


月を2月に変更：2024-02-10

この方法を使えば、日付の各フィールドをより一般的な方法で操作することができ、他のTemporal系クラスとも一貫した記述が可能になります。

6. withメソッドのよくある使用シーン

withメソッドは以下のような場面でよく使われます。

日付の一部だけを変更したいとき
月初や月末に日付を合わせたいとき
特定のパターンで毎月の処理を行いたいとき
定期的なスケジュールを作成する際

例えば、月の初日を取得したい場合は次のように書きます。


import java.time.LocalDate;

public class FirstDayOfMonth {
    public static void main(String[] args) {
        LocalDate now = LocalDate.now();
        LocalDate firstDay = now.withDayOfMonth(1);
        System.out.println("今月の初日：" + firstDay);
    }
}