#12장 새로운 날짜와 시간 API

Raoul-Gabriel Urma 저, 우정은 역 「Modern Java in Action, 2019」를 읽고 정리하였습니다.

• 이 장의 내용

  • 자바8에서 새로운 날짜와 시간 라이브러리를 제공하는 이유 사람이나 기계가 이해 해할 수 있는 날짜와 시간 표현 방법

  • 시간의 양 정의하기

  • 날짜 조작, 포매팅, 파싱

  • 시간대와 캘린더 다루기

12.1 LocalDate, LocalTime, LocalDateTime, Instant, Duration, and Period

• java.time 패키지

• 간단한 dates and intervals 먼저 살펴보자.

LocalDate and LocalTime

• getDayOfMonth() 랑 getDayOfWeek()는 어떻게 나올까?

LocalDate date = LocalDate.of(2017, 9, 21); // 2017-09-21 또는 
// LocalDate today = LocalDate.now();
int year = date.getYear(); // 2017
Month month = date.getMonth(); // SEPTEMBER
int day = date.getDayOfMonth(); // 퀴즈: 머가 나올까?
DayOfWeek dow = date.getDayOfWeek(); // 퀴즈: 머가 나올까?  
int len = date.lengthOfMonth(); // 30
boolean leap = date.isLeapYear(); // false

// 위 퀴즈 답은 각각 21, THURSDAY
// get에게 TemporalField를 넘겨서 temporal 객체의 특정 필드를 가져올 수 있다. 
int year = date.get(ChronoField.YEAR);
int month = date.get(ChronoField.MONTH_OF_YEAR);
int day = date.get(ChronoField.DAY_OF_MONTH);

// 이렇게 가독성 높게 바꿔도 된다
int year = date.getYear();
int month = date.getMonthValue();
int day = date.getDayOfMonth();

LocalTime time = LocalTime.of(13, 45, 20); // 13:45:20
int hour = time.getHour();
int minute = time.getMinute();
int second = time.getSecond();

// 스트링 사용시
LocalDate date = LocalDate.parse("2017-09-21");
LocalTime time = LocalTime.parse("13:45:20");

Combining a date and a time

• LocalDateTime : Date + Time

// 2017-09-21T13:45:20
LocalDateTime dt1 = LocalDateTime.of(2017, Month.SEPTEMBER, 21, 13, 45, 20);
LocalDateTime dt2 = LocalDateTime.of(date, time);
LocalDateTime dt3 = date.atTime(13, 45, 20);
LocalDateTime dt4 = date.atTime(time);
LocalDateTime dt5 = time.atDate(date);

LocalDate date1 = dt1.toLocalDate(); // 2017-09-21
LocalTime time1 = dt1.toLocalTime(); // 13:45:20

Instant: a date and time for machines

• LocalDateTime과 Instant 목적은 다르다. Instant는 기계를 위해서만 사용.

Instant.ofEpochSecond(3);
Instant.ofEpochSecond(3, 0);
// One billion nanoseconds (1 second) after 2 seconds
Instant.ofEpochSecond(2, 1_000_000_000); 
// One billion nanoseconds (1 second) before 4 seconds
Instant.ofEpochSecond(4, -1_000_000_000);

Defining a Duration or a Period

• 두 시점 사이의 시간

Duration d1 = Duration.between(time1, time2);
Duration d1 = Duration.between(dateTime1, dateTime2);
Duration d2 = Duration.between(instant1, instant2);

Period tenDays = Period.between(
	LocalDate.of(2017, 9, 11), LocalDate.of(2017, 9, 21))
Duration threeMinutes = Duration.ofMinutes(3);
Duration threeMinutes = Duration.of(3, ChronoUnit.MINUTES);
Period tenDays = Period.ofDays(10);
Period threeWeeks = Period.ofWeeks(3);
Period twoYearsSixMonthsOneDay = Period.of(2, 6, 1);

12.2 Manipulating, parsing, and formatting dates

// 절대적 방식으로 고치기
LocalDate date1 = LocalDate.of(2017, 9, 21);
LocalDate date2 = date1.withYear(2011); // 2011-09-21
LocalDate date3 = date2.withDayOfMonth(25); // 2011-09-25
LocalDate date4 = date3.with(ChronoField.MONTH_OF_YEAR, 2); // 2011-02-25

// 상대적 방식으로 고치기
LocalDate date1 = LocalDate.of(2017, 9, 21);
LocalDate date2 = date1.plusWeeks(1);
LocalDate date3 = date2.minusYears(6);
LocalDate date4 = date3.plus(6, ChronoUnit.MONTHS);

퀴즈

• date는 무엇이 나올까?

LocalDate date = LocalDate.of(2014, 3, 18);
date = date.with(ChronoField.MONTH_OF_YEAR, 9);
date = date.plusYears(2).minusDays(10);
date.withYear(2011);

TemporalAdjusters

LocalDate date1 = LocalDate.of(2014, 3, 18);
LocalDate date2 = date1.with(TemporalAdjusters.nextOrSame(DayOfWeek.SUNDAY));
LocalDate date3 = date2.with(TemporalAdjusters.lastDayOfMonth());

적절한 TemporalAdjusters의 메소드를 찾을 수 없다면, 아래 인터페이스 상속하여 직접 구현한다.

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

퀴즈

• 오늘 이후로 일해야 되는 다음 날짜를 구해라. (토요일, 일요일 빼기)

date.with(new NextWorkingDay());

정답

class NextWorkingDay implements TemporalAdjuster {
    Temporal adjustInto(Temporal temporal){
        DayOfWeek dow =
            DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
        int dayToAdd = 1;
        if (dow == DayOfWeek.FRIDAY) dayToAdd = 3;
        else if (dow == DayOfWeek.SATURDAY) dayToAdd = 2;
        return temporal.plus(dayToAdd, ChronoUnit.DAYS);
    }
}

// 람다 사용시 
date = date.with(temporal -> {
    DayOfWeek dow =
        DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
    int dayToAdd = 1;
    if (dow == DayOfWeek.FRIDAY) dayToAdd = 3;
    else if (dow == DayOfWeek.SATURDAY) dayToAdd = 2;
    return temporal.plus(dayToAdd, ChronoUnit.DAYS);
});

// TemporalAdjuster를 람다 표현식으로 정의하고 싶다면 ofDateAdjuster 정적 팩토리 메소드의 UnaryOperator<LocalDate> 사용
TemporalAdjuster nextWorkingDay = TemporalAdjusters.ofDateAdjuster(
    temporal -> {
        DayOfWeek dow =
            DayOfWeek.of(temporal.get(ChronoField.DAY_OF_WEEK));
        int dayToAdd = 1;
        if (dow == DayOfWeek.FRIDAY) dayToAdd = 3;
        else if (dow == DayOfWeek.SATURDAY) dayToAdd = 2;
        return temporal.plus(dayToAdd, ChronoUnit.DAYS);
    });
date = date.with(nextWorkingDay);

날짜와 시간 객체 출력과 파싱

• formatting과 parsing: 날짜와 시간 관련 작업에서 필수

• DateTimeFormatter 클래스: 날짜나 시간을 특정 형식의 문자열로 만들 수 있다.

  • java.util.DateFormat 클래스와 달리 스레드 세이프하다.

LocalDate date = LocalDate.of(2014, 3, 18);
String s1 = date.format(DateTimeFormatter.BASIC_ISO_DATE); // 20140318
String s2 = date.format(DateTimeFormatter.ISO_LOCAL_DATE); // 2014-03-18

// 반대로,  문자열을 파싱해서 날짜 객체로 만들시.
LocalDate date1 = LocalDate.parse("20140318",
                                  DateTimeFormatter.BASIC_ISO_DATE); 
LocalDate date2 = LocalDate.parse("2014-03-18",
                                  DateTimeFormatter.ISO_LOCAL_DATE); 
System.out.println(date1); // 2014-03-18
System.out.println(date2); // 2014-03-18

// 특정 패턴으로 포매터 생성시
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd/MM/yyyy");
LocalDate date1 = LocalDate.of(2014, 3, 18);
String formattedDate = date1.format(formatter); // 18/03/2014
LocalDate date2 = LocalDate.parse(formattedDate, formatter); // 2014-03-18

// ofPattern 메서드도 Locale로 포매터를 만들수 있다.
DateTimeFormatter italianFormatter =
    DateTimeFormatter.ofPattern("d. MMMM yyyy", Locale.ITALIAN);
LocalDate date1 = LocalDate.of(2014, 3, 18);
String formattedDate = date.format(italianFormatter); // 18. marzo 2014
LocalDate date2 = LocalDate.parse(formattedDate, italianFormatter); // 2014-03-18

// DateTimeFormatterBuilder 클래스 이용하여, 복합적인 포매터를 정의해서 좀 더 세부적으로 포매터를 제어할 수 있다.
DateTimeFormatter italianFormatter = new DateTimeFormatterBuilder()
    .appendText(ChronoField.DAY_OF_MONTH)
    .appendLiteral(". ")
    .appendText(ChronoField.MONTH_OF_YEAR)
    .appendLiteral(" ")
    .appendText(ChronoField.YEAR)
    .parseCaseInsensitive()
    .toFormatter(Locale.ITALIAN);
// Text(DayOfMonth)'. 'Text(MonthOfYear)' 'Text(Year)ParseCaseSensitive(false)

12.3 다양한 시간대와 캘린더 활용 방법

새로운 날짜와 시간 API을 사용하면, 다양한 시간대를 간단하게 처리할 수 있다.

시간대 사용하기

• ZoneRules클래스에는 40개 정도의 시간대가 있다.


// 날짜와 시간 API에서 제공하는 다른 클래스와 마찬가지로 Zoneld는 불변 클래스다.
ZoneId romeZone = ZoneId.of("Europe/Rome");

// 기존의 TimeZone 객체를 Zoneld 객체로 변환
ZoneId zoneId = TimeZone.getDefault().toZoneId();

// Zoneld 객체를 얻은 다음에는 LocalDate, LocalDateTime, Instant를 이용해서 ZonedDateTime 인스턴스로 변환
LocalDate date = LocalDate.of(2014, Month.MARCH, 18);
ZonedDateTime zdt1 = date.atStartOfDay(romeZone); 
// 2014-03-18T00:00+01:00[Europe/Rome]
LocalDateTime dateTime = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45);
ZonedDateTime zdt2 = dateTime.atZone(romeZone);
// 2014-03-18T13:45+01:00[Europe/Rome]
Instant instant = Instant.now();
ZonedDateTime zdt3 = instant.atZone(romeZone);
// 2022-01-22T20:08:56.291091200+01:00[Europe/Rome]

// Zoneld를 이용해서 LocalDateTime을 Instant로 바꿔보기
Instant instant = Instant.now();
LocalDateTime timeFromInstant = LocalDateTime.ofInstant(instant, romeZone);

UTC/Greenwich 기준의 고정 오프셋

• UTC 기준으로 시간대 표현하는 법

// "뉴욕은 런던보다 5시간 느리다" 표현시
// 하지만, 서머타임을 제대로 처리할 수 없으므로 권장하지 않는 방식
ZoneOffset newYorkOffset = ZoneOffset.of("-05:00");

// ISO-8601 캘린더 시스템에서 정의하는 UTC/GMT와 오프셋으로 날짜와 시간을 표현하는 방법
LocalDateTime dateTime = LocalDateTime.of(2014, Month.MARCH, 18, 13, 45);
OffsetDateTime dateTimeInNewYork = OffsetDateTime.of(date, newYorkOffset);

대안 캘린더 시스템 사용하기

• ThaiBuddhistDate, MinguoDate, OapaneseDate, HijrahDate

LocalDate date = LocalDate.of(2014, Month.MARCH, 18);
JapaneseDate japaneseDate = JapaneseDate.from(date);

// Locale과 Locale에 대한 날짜 인스턴스로 캘린더 시스템을 만드는 방법
Chronology japaneseChronology = Chronology.ofLocale(Locale.JAPAN);
ChronoLocalDate now = japaneseChronology.dateNow(); 

// 하지만 ChronoLocalDate 보다는 LocalDate를 사용하자.

이슬람력

• 가장 복잡하다.

HijrahDate ramadanDate =
    HijrahDate.now().with(ChronoField.DAY_OF_MONTH, 1)
    .with(ChronoField.MONTH_OF_YEAR, 9);
System.out.println("Ramadan starts on " +
                   IsoChronology.INSTANCE.date(ramadanDate) +
                   " and ends on " +
                   IsoChronology.INSTANCE.date(
                       ramadanDate.with(
                           TemporalAdjusters.lastDayOfMonth())));