새로운 JavaScript Temporal 객체 소개 (2025년 1월 24일 실험적 릴리스)

기존 Date 객체의 한계
Temporal 이란?
- Temporal의 핵심 개념
주요 특징
참고 자료

기존 Date 객체의 한계

Date 객체는 JavaScript가 1995년에 만들어질 때 Java의 초기 결함이 있는 java.util.Date API를 그대로 가져와 사용했다. Java 팀은 1997년에 이 문제를 해결했지만, JavaScript는 여전히 이를 유지하고 있다. 이 때문에 여러 가지 문제가 존재한다.

1. 일관성 없는 API와 사용성 문제

Date 객체는 생성, 조작, 포맷팅이 직관적이지 않다.

const date = new Date(2025, 1, 14); // 2025년 2월 14일

월(Month)이 0부터 시작하여 직관적이지 않다.
날짜를 조작할 때 setDate, setMonth 같은 메서드를 직접 호출해야 한다.

2. 불변성(Immutable) 지원 부족

Date 객체는 mutable(변경 가능)하여, 조작 시 부작용이 발생할 수 있다.

const date = new Date(2025, 1, 16);
date.setDate(date.getDate() + 1); // 원본 date 객체가 변경됨

이로 인해 여러 곳에서 같은 객체를 참조하면 예상치 못한 오류가 발생할 수 있다.

3. 시간대(Timezone) 및 UTC 처리의 불편함

Date 객체는 기본적으로 브라우저의 로컬 타임존을 사용하기 때문에, UTC 변환이 번거롭다.

const date = new Date('2025-02-16T00:00:00Z');
console.log(date.toLocaleString('en-US', { timeZone: 'Asia/Seoul' }));

이처럼 toLocaleString을 활용해야 하지만, 브라우저별로 결과가 다를 수 있다. 또한, "시간대 없음"이라는 개념이 부족하여 달력이나 시계를 읽는 시간 개념을 다루기 어렵다.

4. 포맷팅이 불편함

기본 Date 객체에서 날짜를 원하는 형식으로 출력하려면 불편하게 조합해야 한다.

const date = new Date();
console.log(`${date.getFullYear()}-${date.getMonth() + 1}-${date.getDate()}`);

5. 날짜 계산이 불편함

특정 날짜에 N일을 더하는 작업이 직관적이지 않다.

const date = new Date();
date.setDate(date.getDate() + 7);
console.log(date);

이렇게 원본 객체를 수정해야 하는 문제가 있다.

이러한 문제들 때문에 대부분의 프로젝트에서 moment.js, day.js, date-fns 같은 라이브러리를 사용하여 날짜 및 시간을 처리해왔다.

Temporal 이란?

Temporal은 기존 Date 객체의 한계를 극복하고 보다 직관적이고 강력한 날짜/시간 API를 제공하는 새로운 JavaScript 내장 객체다. 현재 실험적 릴리스로 제공되고 있으며, 추후 표준이 될 가능성이 높다.

Temporal의 핵심 개념

Temporal은 순간(Instants), 지역 시간(Wall-clock time), 그리고 기간(Durations) 개념을 명확하게 정의한다.

지속시간(Duration): 두 시점 사이의 차이 (Temporal.Duration)
시점:
- 유니크한 시점
  - 타임스탬프 (Temporal.Instant)
  - 시간대를 포함한 날짜-시간 (Temporal.ZonedDateTime)
- 시간대를 인식하지 않는 날짜/시간 (Plain)
  - 전체 날짜 및 시간: Temporal.PlainDateTime
  - 날짜만: Temporal.PlainDate
  - 연도와 월: Temporal.PlainYearMonth
  - 월과 일: Temporal.PlainMonthDay
  - 시간만: Temporal.PlainTime
현재 시간: Temporal.Now

주요 특징

1. 불변성 (Immutable)

Temporal은 immutable하게 동작하며, 값을 변경하면 새로운 객체를 반환한다.

const today = Temporal.PlainDate.from('2025-02-16');
const tomorrow = today.add({ days: 1 });

console.log(today.toString());   // 2025-02-16 (변경되지 않음)
console.log(tomorrow.toString()); // 2025-02-17 (새 객체 반환)

2. 시간대(Timezone) 지원

ISO 시간대를 명확하게 지정할 수 있다.

const seoulTime = Temporal.Now.zonedDateTimeISO('Asia/Seoul');
console.log(seoulTime.toString()); // 2025-02-16T10:00:00+09:00[Asia/Seoul]

3. 나노초 단위 지원

기존 Date 객체는 밀리초(ms)까지만 지원했지만, Temporal은 나노초(ns)까지 정밀하게 다룰 수 있다.

const now = Temporal.Now.instant();
console.log(now.epochNanoseconds); // 1708049295000000000 (나노초 단위)

4. ISO 8601 포맷 기본 지원

const date = Temporal.PlainDateTime.from('2025-02-16T15:30:00');
console.log(date.toString()); // 2025-02-16T15:30:00

5. 날짜 간격 계산 간편화

Temporal에서는 since() 메서드를 사용해 날짜 차이를 쉽게 계산할 수 있다.

const start = Temporal.PlainDate.from('2025-02-16');
const end = Temporal.PlainDate.from('2025-03-01');
const diff = end.since(start);
console.log(diff.days); // 13

6. 기간 정렬 가능

Temporal.Duration.compare를 활용해 기간을 정렬할 수 있다.

const durations = [
  Temporal.Duration.from({ hours: 1 }),
  Temporal.Duration.from({ hours: 2 }),
  Temporal.Duration.from({ hours: 1, minutes: 30 }),
  Temporal.Duration.from({ hours: 1, minutes: 45 }),
];

durations.sort(Temporal.Duration.compare);
console.log(durations.map((d) => d.toString()));
// [ 'PT1H', 'PT1H30M', 'PT1H45M', 'PT2H' ]