美容院の常連客

TemporalAdjusters

LocalDateのようなjava.timeのオブジェクトを扱っていると、「その月の第2火曜日」を求めるような複雑な日付の調整が必要になることがよくあります。 これを手作業で計算する代わりに、**TemporalAdjusters**を使うことができます。

java.time.temporal.TemporalAdjusters（複数形の's'が付いていることに注意してください）というユーティリティクラスには、よく使われる日付調整のためのstaticメソッドが多数用意されています。 これらの調整は、LocalDateのような時間的オブジェクトに対して.with()メソッドを呼び出すことで適用します。

import java.time.LocalDate;
import java.time.Month;
import java.time.DayOfWeek;
import java.time.temporal.TemporalAdjusters;

LocalDate date = LocalDate.of(2024, Month.AUGUST, 15); // 2024-08-15 (a Thursday)

// Use a predefined adjuster: find the last day of the month
LocalDate lastDay = date.with(TemporalAdjusters.lastDayOfMonth());
// => 2024-08-31

スケジュールの計算に役立つアジャスターを、いくつか見てみましょう。

第n曜日を求める

dayOfWeekInMonth(int ordinal, DayOfWeek dayOfWeek)を使うと、ある曜日がその月の何回目にあたるかを求められます。

// Find the second Tuesday of August 2024
LocalDate secondTuesday = date.with(TemporalAdjusters.dayOfWeekInMonth(2, DayOfWeek.TUESDAY));
// => 2024-08-13

月内で最初または最後の曜日を求める

firstInMonth(DayOfWeek dayOfWeek)またはlastInMonth(DayOfWeek dayOfWeek)を使います。

// Find the last Monday of August 2024
LocalDate lastMonday = date.with(TemporalAdjusters.lastInMonth(DayOfWeek.MONDAY));
// => 2024-08-26

相対的な調整（次・前）

next()、previous()、nextOrSame()、previousOrSame()などのアジャスターは、現在の日付を基準にして、指定した曜日が次または前に現れる日を求めます。

• next()/previous()：現在の日付が該当する場合は含めません。
• nextOrSame()/previousOrSame()：現在の日付が該当する場合は含めます。

LocalDate thursday = LocalDate.of(2024, Month.AUGUST, 15); // A Thursday

// Find the next Thursday (exclusive)
LocalDate nextThursday = thursday.with(TemporalAdjusters.next(DayOfWeek.THURSDAY));
// => 2024-08-22

// Find the next Thursday (inclusive) - returns the same date
LocalDate nextOrSameThursday = thursday.with(TemporalAdjusters.nextOrSame(DayOfWeek.THURSDAY));
// => 2024-08-15

// Find the previous Monday (exclusive)
LocalDate previousMonday = thursday.with(TemporalAdjusters.previous(DayOfWeek.MONDAY));
// => 2024-08-12

独自のアジャスター

TemporalAdjusterは関数型インターフェースなので、調整対象の時間的オブジェクトを受け取り、調整後のオブジェクトを返すラムダとして、独自のアジャスターを書くことができます。 定義済みのアジャスターと同じように.with()で適用でき、その内部で定義済みのアジャスターを使うこともできます。

import java.time.temporal.TemporalAdjuster;

// An adjuster that moves a weekend date to the following Monday
TemporalAdjuster skipWeekend = temporal -> {
    DayOfWeek day = DayOfWeek.from(temporal);
    if (day == DayOfWeek.SATURDAY || day == DayOfWeek.SUNDAY) {
        return temporal.with(TemporalAdjusters.next(DayOfWeek.MONDAY));
    }
    return temporal;
};

LocalDate saturday = LocalDate.of(2024, Month.AUGUST, 17);
LocalDate monday = saturday.with(skipWeekend);
// => 2024-08-19

TemporalAdjustersクラスのこれらのアジャスターを使えば、日付を操作する作業を大幅にシンプルにできます。