[Java] Class TemporalAdjusters

package java.time

Date와 Calendar가 가지고 있던 단점들을 개선한 패키지.

4개의 하위 패키지를 가지고 있다.

날짜나 시간을 변경하는 메서드들은 항상 변경된 새로운 객체를 반환한다. = 불변Immutable

Class TemporalAdjusters

자주 쓰일만한 날자 계산들을 대신 해주는 메서드들을 정의해놓은 클래스

TemporalAdjuster 인터페이스를 구현한 클래스의 객체를 LocalDate의 with() 메서드에 매개변수로 전달하여 사용한다.

import java.time.temporal.TemporalAdjusters;

LocalDate today = LocalDate.now();
LocalDate nextMonday = today.with(TemporalAdjusters.next(DayOfWeek.MONDAY));   // 2017-09-11

Method

직접 구현하기

• interface TemporalAdjuster
  

    단 하나 정의되어 있는 추상 메서드만 구현하면 된다.

    실제로 구현해야 하는 것은 adjustInto()지만, 이 메서드는 내부적으로만 사용할 의도로 작성되어 있다.

    따라서 TemporalAdjuster와 같이 사용해야 하는 with()를 사용하도록 한다.

@FunctionalInterface
public interface TemporalAdjuster{
    Temporal adjustInto(Temporal temporal);
}

• with()
  

    LocalDate의 with()는 TemporalAdjuster 인터페이스를 구현한 클래스의 객체를 매개변수로 받는다.

    with는 LocalTime, LocalDateTime, Instant 등 대부분의 날짜와 시간에 관련된 클래스에 포함되어 있다.

LocalDate with(TemporalAdjuster adjuster)

• adjustInto()
  

    날짜와 시간에 관련된 대부분의 클래스는 Temporal 인터페이스를 구현하였으므로 이 메서드의 매개변수가 될 수 있다.

class TestDayAddFive implements TemporalAdjuster {
    @Override
    public Temporal adjustInto(Temporal temporal){
        return temporal.plus(5, ChronoUnit.DAYS);
    }
}

Example

import java.time.*;
import java.util.*;
import java.time.temporal.*;

class Test {
	public static void main(String[] args) {
		LocalDate today = LocalDate.now();
		LocalDate date = today.with(new DayAddFive());
		
		print(today);        // 2017-09-08
		print(date);         // 2017-09-13

		print(today.with(TemporalAdjusters.firstDayOfNextYear()));                       // 2018-01-01
		print(today.with(TemporalAdjusters.firstDayOfNextMonth()));                      // 2017-10-01
                print(today.with(TemporalAdjusters.firstDayOfYear()));                           // 2017-01-01
                print(today.with(TemporalAdjusters.firstDayOfMonth()));                          // 2017-09-01
		print(today.with(TemporalAdjusters.lastDayOfYear()));                            // 2017-12-31
		print(today.with(TemporalAdjusters.lastDayOfMonth()));                           // 2017-09-30
		print(today.with(TemporalAdjusters.firstInMonth(DayOfWeek.FRIDAY)));             // 2017-09-01
		print(today.with(TemporalAdjusters.lastInMonth(DayOfWeek.FRIDAY)));              // 2017-09-29
		print(today.with(TemporalAdjusters.previous(DayOfWeek.FRIDAY)));                 // 2017-09-01
		print(today.with(TemporalAdjusters.previousOrSame(DayOfWeek.FRIDAY)));           // 2017-09-08
		print(today.with(TemporalAdjusters.next(DayOfWeek.FRIDAY)));                     // 2017-09-15
		print(today.with(TemporalAdjusters.nextOrSame(DayOfWeek.FRIDAY)));               // 2017-09-08
		print(today.with(TemporalAdjusters.dayOfWeekInMonth(4, DayOfWeek.FRIDAY)));      // 2017-09-22

    }

	public static void print(Object obj){
		System.out.println(obj);
	}
}

class DayAddFive implements TemporalAdjuster {
    @Override
    public Temporal adjustInto(Temporal temporal) {
        return temporal.plus(5, ChronoUnit.DAYS);
    }
}

TemporalAdjusters API

참고 서적: 자바의 정석 3판 2