• 자바 8에 새로운 날짜와 시간 API가 생긴 이유
  • 그전까지 사용하던 java.util.Date 클래스는 mutable 하기 때문에 thead safe하지 않다.
  • 클래스 이름이 명확하지 않다. Date인데 시간까지 다룬다.
  • 버그 발생할 여지가 많다. (타입 안정성이 없고, 월이 0부터 시작한다거나..)
  • 날짜 시간 처리가 복잡한 애플리케이션에서는 보통 Joda Time을 쓰곤했다.
• 자바 8에서 제공하는 Date-Time API
  • JSR-310 스팩의 구현체를 제공한다.
  • 디자인 철학
    • Clear
    • Fluent
    • Immutable
    • Extensible
• 주요 API
  • 기계용 시간 (machine time)과 인류용 시간(human time)으로 나눌 수 있다.
  • 기계용 시간은 EPOCK (1970년 1월 1일 0시 0분 0초)부터 현재까지의 타임스탬프를 표현한다.
  • 인류용 시간은 우리가 흔히 사용하는 연,월,일,시,분,초 등을 표현한다.
  • 타임스탬프는 Instant를 사용한다.
  • 특정 날짜(LocalDate), 시간(LocalTime), 일시(LocalDateTime)를 사용할 수 있다.
  • 기간을 표현할 때는 Duration (시간 기반)과 Period (날짜 기반)를 사용할 수 있다.
  • DateTimeFormatter를 사용해서 일시를 특정한 문자열로 포매팅할 수 있다.

Date와 Time API

• 지금 이 순간을 기계 시간으로 표현하는 방법

  /*
  	기준시 UTC, GMT
  */
  Instant instant = Instant.now(); // 2022-08-28T22:23:53.912348Z
  
  /*
  	나의 Local시간
  */
  ZoneId zone = ZoneId.systemDefault(); // Asia/Seoul
  ZonedDateTime zonedDateTime = instant.atZone(zone); // 2022-08-29T07:26:22.135012+09:00[Asia/Seoul]
  

• 인류용 일시를 표현하는 방법

  /*
  	서버의 Zone정보를 참고해서 해당 Local 시간을 리턴한다.
  */
  LocalDateTime now = LocalDatetime.now(); // 2022-08-29T07:28:10.781728
  
  /*
  	of의 인자값은 순서대로 년도, 월, 일, 시간, 분, 초이다.
  */
  LocalDateTime birthDay = LocalDateTime.of(1989, Month.MARCH, 4, 0, 0, 0);
  
  ZonedDateTime nowInKorea = ZonedDateTime.now(ZoneId.of("Asia/Seoul"));
  

• 기간을 표현하는 방법

  LocalDate today = LocalDate.now();
  LocalDate nextBirthday = LocalDate.of(2023, Month.MARCH, 3);
  Period period = Period.between(today, nextBirthday);
  

• 파싱 또는 포매팅

  LocalDateTime now = LocalDatetime.now();
  DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofPattern("MM/dd/yyyy");
  String format = now.format(dateTimeFormatter);
  
  LocalDate parse = LocalDate.parse("03/04/1989", dateTimeFormatter);
  

• 레거시 API 지원

  • GregorianCalendar와 Date 타입의 인스턴스를 Instant나 ZonedDateTime으로 변환 가능.
  • java.util.TimeZone에서 java.time.ZoneId로 상호 변환 가능.

  ---

  https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html#predefined

  https://codeblog.jonskeet.uk/2017/04/23/all-about-java-util-date/

  https://docs.oracle.com/javase/tutorial/datetime/overview/index.html

  https://docs.oracle.com/javase/tutorial/datetime/iso/overview.html