[Java] Class LocalDate, LocalTime

package java.time

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

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

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

Class LocalDate와 LocalTime

java.time 패키지의 가장 기본이 되는 클래스들.

나머지 클래스들은 이들의 확장.

static LocalDate/LocalTime now()

현재의 날짜와 시간을 LocalDate와 LocalTime으로 각각 반환한다.

LocalDate date = LocalDate.now();
LocalTime time = LocalTime.now();

static LocalDate/LocalTime of()

지정된 날짜와 시간으로 LocalDate와 LocalTime 객체를 생성한다.

static LocalDate of(int year, int month, int dayOfMonth)
static LocalDate of(int year, Month month, int dayOfMonth)

static LocalTime of(int hour, int minute, int second)
static LocalTime of(int hour, int minute, int second, int nanoOfSecond)
static LocalTime of(int hour, int minute)

LocalDate date = LocalDate.of(2017, 09, 03);                    // 2017-09-03
LocalTime time = LocalTime.of(17, 41, 30);                      // 17:41:30

일, 초 단위로 지정할 수 있다.

LocalDate date = LocalDate.ofYearDay(2017, 365);                //2017-12-31  
LocalTime time = LocalTime.ofSecondOfDay(17*3600+41*60+30);     //17:41:30

parse()

문자열을 날짜와 시간으로 변환

LocalDate date = LocalDate.parse("2017-09-03");       // 2017-09-03
LocalTime time = LocalTime.parse("17:41:30");         // 17:41:30

특정 필드의 값 가져오기 getXXX()

Calendar와 달리 월(month)의 범위가 1~12고, 요일은 월요일 1 ~ 일요일 7이다.

• LocalDate
  

• LocalTime
  

특정 필드의 값 가져오기 get()

int타입의 범위를 넘어서는 필드는 getLong()을 사용해야 한다.

import java.time.temporal.ChronoField;

LocalDate data = LocalDate.now();
System.out.println(data.get(ChronoField.ERA));
System.out.println(data.getLong(ChronoField.EPOCH_DAY));

• LocalDate - int get(TemporalField field)

• LocalDate - long getLong(TemporalField field)
  

• LocalTime - int get(TemporalField field)
  

• LocalTime - long getLong(TemporalField field)
  

• range()
  

    상수 끝에 붙이면 특정 필드가 가질 수 있는 값의 범위를 알 수 있다.

System.out.println(ChronoField.HOUR_OF_DAY.range());       // 0 - 23

필드의 값 변경하기

• with()
  

     원하는 필드를 직접 지정하여 변경할 수 있다.

LocalDate with(TemporalField field, long newValue)
LocalTime with(TemporalField field, long newValue)

    with로 시작하는 메서드를 사용하여 날짜와 시간에서 특정 필드 값을 변경할 수 있다.

LocalDate withDayOfMonth(int dayOfMonth)
LocalDate withDayOfYear(int dayOfYear)
LocalDate withMonth(int month)
LocalDate withYear(int year)

LocalTime withHour(int hour)
LocalTime withMinute(int minute)
LocalTime withNano(int nanoOfSecond)
LocalTime withSecond(int second)

    필드를 변경하는 메서드들은 항상 새로운 객체를 생성한다.

• plus(), minus()
  

     특정 필드에 값을 더하거나 뺀다.

     plus를 minus로 바꾸면 minus 메서드가 된다.

LocalTime plus(TemporalAmount amountToAdd)
LocalTime plus(long amountToAdd, TemporalUnit unit)
LocalTime plusHours(long hoursToAdd)
LocalTime plusMinutes(long minutesToAdd)
LocalTime plusNanos(long nanosToAdd)
LocalTime plusSeconds(long secondstoAdd)

LocalDate plus(TemporalAmount amountToAdd)
LocalDate plus(long amountToAdd, TemporalUnit unit)
LocalDate plusDays(long daysToAdd)
LocalDate plusMonths(long monthsToAdd)
LocalDate plusWeeks(long weeksToAdd)
LocalDate plusYears(long yearsToAdd)

날짜와 시간 비교

• int compareTo(ChronoLocalDate other)
  

     LocalDate와 LocalTime도 적절히 오버라이딩되어 있어 사용할 수 있다.

     같으면 0, 이전이면 -1, 이후면 1

LocalDate date1 = LocalDate.now();               // 2017-09-03
LocalDate date2 = LocalDate.of(2017, 9, 17);

System.out.println(date1.compareTo(date2));      // -14

• boolean isAfter(ChronoLocalDate other)
  

    other보다 이후 날짜인지 비교한다.

System.out.println(date1.isAfter(date2));        // true

• boolean isEqual(ChronoLocalDate other)
  

     연표(chronology)가 다른 두 날짜가 동일한지 비교한다.

     모든 필드가 일치해야 하는 equals()와 달리 오직 날짜만을 비교한다.

     LocalDate에만 있다.

import java.time.chrono.JapaneseDate;

LocalDate kDate = LocalDate.of(2017, 9, 03);
JapaneseDate jDate = JapaneseDate.of(2017, 9, 03);

System.out.println(kDate.equals(jDate));   // false
System.out.println(kDate.isEqual(jDate));  // true

• boolean isBefore(ChronoLocalDate other)
  

     other보다 이전 날짜인지 비교한다.

System.out.println(date1.isBefore(date2));      // false

toEpochDay()

Epoch Day인 '1970-01-01'부터 날짜/시간을 세어서 반환한다.

Period/Duration을 대신하여 두 날짜간의 일수 또는 시간 차이를 계산할 수 있다.

단, 날짜는 두 날짜 모두 Epoch Day 이후의 것이어야 한다.

LocalDate API

LocalTime API

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