HOWTO · Java
자바 날짜 대 LocalDate
이 튜토리얼은 Java에서 date와 localdate의 차이점을 보여줍니다.
이 페이지의 내용
Java의 Date와 LocalDate는 서로 다른 값을 나타냅니다. Date는 밀리초 정밀도로 타임라인상의 한 순간을 나타냅니다. LocalDate는 생일처럼 시간이나 시간대가 없는 달력 날짜를 나타냅니다. 값이 특정 순간인지 달력상의 날짜인지에 따라 적절한 타입을 선택하세요.
Java Date와 LocalDate 비교
java.util.Date는 레거시 타입입니다. 저장된 값은 특정 순간을 식별하며 달력 시간대를 저장하지 않습니다. 이 값을 형식화하거나 달력 필드로 변환할 때는 선택한 시간대(흔히 시스템 기본 시간대)를 기준으로 해석합니다. 따라서 표시되는 날짜는 시간대에 따라 달라질 수 있습니다.
java.time.LocalDate는 java.time 패키지에 속합니다. 불변 객체이며 연도, 월, 일 필드를 담지만 시간, 오프셋, 시간대는 포함하지 않습니다. 따라서 이 값만으로는 특정 순간을 식별할 수 없습니다. 날짜를 더하거나 빼면 기존 값이 바뀌는 대신 새로운 LocalDate가 반환됩니다.
| 항목 | java.util.Date |
java.time.LocalDate |
|---|---|---|
| 의미 | 타임라인상의 한 순간 | 달력 날짜 |
| 시간대 | 저장되지 않음. 변환하거나 표시할 때 시간대를 선택 | 없음. 특정 순간을 식별하지 않음 |
| 정밀도 | 밀리초 | 하루 단위 |
| 변경 가능 여부 | 변경 가능 | 불변 |
| 일반적인 용도 | Date를 요구하는 API와 연동 |
생일, 마감일 및 그 밖의 날짜 전용 값 |
이름과 달리 Date는 날짜 전용 타입이 아닙니다. 특정 시각에 발생하는 예정된 이벤트에는 순간을 나타내는 타입을 사용하고, 표시할 때 시간대를 적용하세요. 보는 사람의 위치와 관계없이 같은 날짜로 유지되어야 하는 업무상 날짜에는 LocalDate를 사용하세요.
Date와 레거시 API 사용하기
기존 라이브러리와 인터페이스는 여전히 java.util.Date를 받거나 반환할 수 있습니다. 호환성이 필요한 경계에서는 이 타입을 유지하고, 타임라인상의 순간이라는 의미를 명확히 하려면 Instant를 사용하세요. Date.toInstant()와 Date.from(Instant)를 사용하면 레거시 타입과 최신 시간 API 사이를 변환할 수 있습니다.
다음 예제를 실행해 보세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
import java.time.Instant;
import java.time.LocalDate;
import java.time.ZoneId;
import java.util.Date;
public class Main {
public static void main(String[] args) {
Date legacyDate = Date.from(Instant.parse("2024-03-10T00:30:00Z"));
Instant instant = legacyDate.toInstant();
LocalDate dateInNewYork = instant.atZone(ZoneId.of("America/New_York")).toLocalDate();
System.out.println("Instant: " + instant);
System.out.println("New York date: " + dateInNewYork);
}
}
Instant: 2024-03-10T00:30:00Z
New York date: 2024-03-09
이 프로그램은 고정된 순간에서 시작해 레거시 API에 전달할 수 있도록 Date로 변환한 뒤, 다시 Instant로 변환합니다. 뉴욕 시간대를 적용하면 해당 지역의 달력 날짜를 알 수 있습니다. 아래는 제공된 실행에서 나온 결과입니다. 코드와 출력 블록은 정본과 바이트 단위로 동일하게 유지되므로, 그 안의 레이블은 영어로 표시됩니다.
Date가 표시할 때 사용한 시간대를 보존한다고 생각해서는 안 됩니다. 같은 순간이라도 시간대에 따라 현지 날짜가 달라질 수 있습니다. 기존 API에 맞춰 변환할 때 달력 날짜가 필요하다면 변환에 사용할 시간대를 명시하세요.
LocalDate 만들고 사용하기
시스템 기본 시간대의 현재 날짜를 얻으려면 LocalDate.now()를 사용하세요. 특정 지역의 날짜가 필요하면 ZoneId를 전달할 수 있습니다. 시간대에 따라 반환되는 달력 날짜가 결정되며, 결과인 LocalDate에는 그 시간대가 저장되지 않습니다. 날짜를 지정하려면 LocalDate.of(year, month, day)를 사용하세요. 입력이 기준 시점부터 지난 날짜 수나 한 해 안에서의 날짜 번호라면 ofEpochDay와 ofYearDay를 사용할 수 있습니다.
다음 예제를 실행해 보세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
import java.time.LocalDate;
import java.time.Month;
import java.time.ZoneId;
public class Main {
public static void main(String[] args) {
LocalDate todayInTokyo = LocalDate.now(ZoneId.of("Asia/Tokyo"));
LocalDate dueDate = LocalDate.of(2025, Month.JANUARY, 15);
LocalDate epochDay = LocalDate.ofEpochDay(300);
LocalDate hundredthDay = LocalDate.ofYearDay(2024, 100);
System.out.println("Tokyo date: " + todayInTokyo);
System.out.println("Due date: " + dueDate);
System.out.println("Epoch day 300: " + epochDay);
System.out.println("Day 100 of 2024: " + hundredthDay);
}
}
Tokyo date: 2026-11-04
Due date: 2025-01-15
Epoch day 300: 1970-10-28
Day 100 of 2024: 2024-04-09
LocalDate.now(ZoneId)는 지정된 시간대의 날짜를 얻는 유효한 방법입니다. 시스템 기본 시간대와 다른 업무 시간대를 사용하는 서비스에서 유용합니다. of로 만든 날짜는 명시적으로 지정되어 안정적인 반면, now의 결과는 실행 시점의 시계와 시간대에 따라 달라집니다. 위 도쿄 날짜는 제공된 실행의 현재 날짜 출력에 해당합니다. 출력 블록의 레이블은 예제와 바이트 단위로 동일하게 보존되어 영어로 표시됩니다.
Date와 LocalDate 중에서 선택하기
생일, 청구일, 마감일처럼 의미 있는 시각이 없는 달력 날짜에는 LocalDate를 사용하세요. 어떤 일이 발생한 시점을 나타내려면 순간을 담는 타입을 사용하세요. 특정 장소의 현지 날짜나 시각이 필요하면 명시적인 ZoneId를 통해 그 순간을 변환하세요.
레거시 API가 요구하는 경우에는 Date를 유지하고, 새 날짜 전용 로직의 기본 표현으로 삼는 대신 API 경계에서 변환하세요. 요약하면 달력상의 날짜에는 LocalDate, 특정 순간에는 순간을 담는 타입, 이전 인터페이스와의 호환성에는 Date를 사용하면 됩니다.