[JAVA 8+] java.time 패키지

https://docs.oracle.com/javase/8/docs/api/java/time/package-summary.html

java.time (Java Platform SE 8 )

 

 java.time 패키지

 

기존 `java.util.Date`와 `java.util.Calendar` api 단점을 보완한다.

직관적이고 편리한 기능 제공함

 

( 1.Date 객체는 밀리초 형태로 값을 저장해서 사람이 읽기 어려움

2. 월 값이 0부터 시작 (0~11) 비직관적 설계

3.타임존 설정이 별도로 필요함 ..등등)

 

---

 

설계 /구조 장점

 

 

불변성	java.time 클래스는 대부분 불변(immutable)
스레드 안전성	불변성을 가지므로 스레드 안전성이 기본적으로 보장
api 직관성	더 읽기 쉽고 직관적인 API를 제공
날짜표현	LocalDate, LocalTime, LocalDateTime으로 구분
타임존 관리	ZonedDateTime, OffsetDateTime으로 쉽게 관리
시간 연산	메서드 체이닝으로 쉽게 연산 가능 (plusDays, minusHours 등).
포맷팅/파싱	DateTimeFormatter 클래스 사용 (스레드 안전).

 

 

* 타임존

지구의 서로 다른 지역에서 사용하는 표준 시간

지역마다 표준시간을 설정한다.

지구를 24개의 시간대로 나누며, 각 시간대는 UTC(협정 세계시)를 기준으로 ±X시간으로 표시된다.

한국의 경우 KST (Korea Standard Time), 즉 UTC+9가 표준 시간임

 

* 불변성

객체의 상태가 한 번 생성 된 이후 변경되지 않는 특성

 

* 메서드 체이닝

객체의 메서드 호출을 연속적으로 연결하여 여러 메서드를 한 번에 호출하는 기법

 

 

---

 

java.time 클래스

* 시간대를 저장하지 않는다는 의미 :  시간(시, 분, 초)만을 저장, 시간대(예: UTC, GMT, Asia/Seoul 등) 정보는 포함되지 않는다는 뜻

• Clock :  현재 시간(Instant), 날짜 및 시간을 특정 타임존에서 가져오는 데 사용
• Duration  :  시간 기반 시간 간격 ` '34.5초' `
• Instant  :   UTC 시간선을 기준으로 한 특정 시점  ` 1970-01-01T00:00:00Z `
• LocalDate : 시간대를 포함하지 않는 날짜를 나타냄. `2007-12-03`

LocalDate.now(): 현재 날짜.
LocalDate.of(2024, 12, 25): 특정 날짜 생성.

• LocalDateTime :  시간대를 포함하지 않는 날짜와 시간. ` 2007-12-03T10:15:30`

LocalTime.now(): 현재 시간.
localTime.minusHours(3): 3시간 감소.

 

• LocalTime  :  시간대를 포함하지 않는 시간. `10:15:30`

LocalTime.now(): 현재 시간.
localTime.minusHours(3): 3시간 감소.

 

 

• MonthDay  :  연도 없이 월-일만 나타냄 `--12-03`
• OffsetDateTime  :  UTC 오프셋이 있는 날짜-시간.
• OffsetTime  :  UTC 오프셋이 있는 시간.
• Period  :  날짜 기반의 시간 간격 (연도, 월, 일 단위)  ` '2년, 3개월, 4일' `
• Year  :  연도만 표현 `2024`
• YearMonth  :  연도와 월 `2024-12`
• ZonedDateTime  :  시간대를 포함하는 날짜-시간 `2007-12-03T10:15:30+01:00[Europe/Paris]`
• ZoneId  :  시간대 ID  `Europe/Paris`
• ZoneOffset  :  UTC 시간으로부터의 오프셋 `+02:00`