선택한 기간에 대한 데이터를 검색하는 동안 계산이 약간씩 틀린 것을 발견했습니다. 그런데 날짜를 하루 줄였더니 데이터가 정확히 일치하더군요!

흠… 코드에서 날짜를 처리하는 방식에 문제가 있을 수 있습니다. 어쩌면 시간대가 올바르게 처리되지 않았을 수도 있습니다. 그렇습니다. 제가 옳았습니다!

다른 시간대의 사용자가 포함된 애플리케이션을 구축할 때 날짜를 적절하게 처리하는 것이 까다로울 수 있습니다. UTC로 날짜를 저장하는 것은 일관성을 보장하기 위한 일반적인 모범 사례이지만 사용자가 현지 시간대로 날짜를 입력하는 경우, 특히 필터링 및 쿼리 중에 상황이 복잡해질 수 있습니다.

개발자는 이러한 변환을 처리하기 위해 기본 JavaScript 날짜 개체를 사용하는 경우가 많습니다. 그러나 이 접근 방식은 Node.js와 Chrome과 같은 브라우저 콘솔 등 환경 전반에 걸쳐 불일치를 초래할 수 있습니다. 이 문서에서는 날짜 및 시간대 변환을 올바르게 처리하는 것이 중요한 이유, Luxon을 통해 이 프로세스를 더 쉽게 만들 수 있는 방법, 기본 JavaScript Date 개체에 의존하면 불일치가 발생할 수 있는 이유

문제: UTC 저장과 현지 시간 필터링

날짜가 UTC로 저장되면 시간대로 인한 모호성을 제거하는 글로벌 표준을 나타냅니다. 그러나 사용자는 일반적으로 현지 시간대를 기준으로 생각합니다. 이러한 불일치는 사용자가 현지 시간 입력을 사용하여 날짜별로 레코드를 필터링하려고 할 때 분명해집니다.

사용자의 현지 시간 입력이 제대로 처리되지 않으면 기록이 누락될 수 있는 예를 살펴보겠습니다.

예제 시나리오: GMT-7 시간대의 사용자

GMT-7 시간대(태평양 일광절약시간)에 있는 사용자를 상상해 보세요. 2024년 9월 5일 현지 시간 오후 10시에 음반을 만듭니다. 뒤에서 일어나는 일은 다음과 같습니다.

• 2024년 9월 5일 오후 10시 GMT-7는 2024년 9월 6일 오전 05시 UTC로 변환되어 데이터베이스에 그대로 저장됩니다.
• 그러나 사용자는 이 기록을 9월 5일에 생성한 것으로 인식합니다.

필터 불일치

이제 사용자가 9월 5일에 생성된 모든 레코드를 쿼리하려고 한다고 가정합니다. 그들은 기록을 검색할 것으로 예상하면서 날짜 2024년 9월 5일을 입력했습니다. 그러나 시스템이 시간대 차이를 조정하지 않고 입력 날짜를 저장된 UTC 날짜와 직접 비교하는 경우 사용자는 기록을 누락하게 됩니다. 왜?

• 기록이 데이터베이스에 9월 6일(UTC)로 저장되었습니다.
• 사용자가 9월 5일(현지 시간)로 필터링하지만 시스템은 이를 UTC와 비교하여 일치하는 항목이 없습니다.

JavaScript 날짜 객체: 환경 간 불일치

다음 예제 코드는 특히 Node.js 및 브라우저(예: Chrome 콘솔)와 같은 다양한 환경에서 날짜 및 시간 변환을 처리하기 위해 기본 JavaScript Date 개체를 사용할 때 발생하는 일반적인 문제를 보여줍니다.

예제 코드:

function convertToUtcStartOfDay(isoString) {
  // Step 1: Parse the ISO string into a Date object
  let localDate = new Date(isoString);

  // Step 2: Set the time to the start of the day (00:00:00) in local time zone
  localDate.setHours(0, 0, 0, 0);

  // Step 3: Get the UTC time using toISOString() – it converts local time to UTC
  let utcStartOfDay = localDate.toISOString();

  return utcStartOfDay; // This will be in UTC
}

// Example usage:
let frontendDate = "2023-08-22T00:00:00 05:30"; // ISO string with timezone offset
let startOfDayUtc = convertToUtcStartOfDay(frontendDate);

console.log(startOfDayUtc); // Expected output: "2023-08-21T18:30:00.000Z"

이 예시에서는 사용자가 날짜 "2023-08-22T00:00:00 05:30"(GMT 5:30 시간대 기준)을 입력합니다. Date 객체는 이를 UTC 기준 하루의 시작으로 변환해야 하지만 실행되면 다음과 같습니다.

• Node.js에서 출력은 2023-08-21T00:00:00.000Z - 잘못입니다.
• Chrome 콘솔에서 출력은 2023-08-21T18:30:00.000Z - 올바름입니다.

이러한 불일치로 인해 코드가 실행되는 위치에 따라 예측할 수 없는 결과가 발생할 수 있습니다. 이 동작으로 인해 Date 객체는 다양한 환경에서 일관되게 날짜를 처리하기가 어렵습니다.

정확한 날짜 처리를 위해 Luxon 사용

이 문제를 해결하려면 환경 전반에 걸쳐 일관된 동작을 제공하는 Luxon과 같은 라이브러리를 사용하는 것이 중요합니다. Luxon은 사용자의 로컬 입력을 해당 시간대의 적절한 시작 및 종료로 변환한 다음 정확한 데이터베이스 쿼리를 위해 해당 시간을 UTC로 변환하는 데 도움을 줍니다.

다음은 Luxon을 사용하여 이를 처리하는 예입니다.

const { DateTime } = require('luxon');

// Example user input date in ISO string with timezone information from the frontend
const userInputDate = "2023-08-22T00:00:00 05:30"; // ISO string sent by frontend

// Step 1: Parse the ISO string to get the user's local time
const userLocalDate = DateTime.fromISO(userInputDate);

// Step 2: Convert this date to start of the day and end of the day in the user's local timezone
const startOfDayLocal = userLocalDate.startOf('day'); // start of the day in the user's timezone
const endOfDayLocal = userLocalDate.endOf('day'); // end of the day in the user's timezone

// Step 3: Convert these local start and end times to UTC
const startOfDayUtc = startOfDayLocal.toUTC().toJSDate(); // start of the day in UTC
const endOfDayUtc = endOfDayLocal.toUTC().toJSDate(); // end of the day in UTC

// Step 4: Query the database using the UTC range
db.records.find({
  createdAt: {
    $gte: startOfDayUtc,
    $lte: endOfDayUtc
  }
});

Luxon이 JavaScript 날짜 객체보다 나은 이유

기본 자바스크립트 날짜 개체를 사용하여 날짜 및 시간대 변환을 직접 처리하면 위에서 설명한 것과 같은 불일치가 발생할 수 있습니다. Luxon이 더 나은 대안인 몇 가지 이유는 다음과 같습니다.

1. 환경 전반에 걸친 일관성: Luxon은 코드가 Node.js에서 실행되든 브라우저(예: Chrome 콘솔)에서 실행되든 일관된 동작을 제공합니다. 이는 다양한 환경에서 Date 객체를 사용할 때 발생하는 불일치를 제거합니다.

2. 내장 시간대 지원: Luxon을 사용하면 시간대 간 변환이 쉬운 반면 Date 객체는 시간대 조작에 대한 강력한 지원을 제공하지 않습니다.

3. 간단한 날짜 조작: 하루의 시작 또는 끝을 사용자의 현지 시간대로 설정하고 이를 UTC로 변환하는 것은 글로벌 애플리케이션에서 일반적인 작업입니다. Luxon은 직관적인 API로 이 프로세스를 단순화하는 반면 Date는 복잡한 수동 처리가 필요합니다.

결론

날짜 및 시간대 변환을 올바르게 처리하는 것은 안정적이고 사용자 친화적인 애플리케이션을 구축하는 데 중요합니다. 개발자가 레코드를 필터링할 때 시간대 차이를 고려하지 못하면 사용자가 중요한 데이터를 놓칠 수 있으며 이로 인해 혼란이 발생하고 심각한 오류가 발생할 수 있습니다.

기본 JavaScript 날짜 객체 대신 Luxon을 사용하면 일관성, 더 나은 시간대 처리 및 날짜 조작이 더 쉬워집니다. 이를 통해 개발자는 다양한 시간대의 사용자를 위한 원활한 환경을 조성하여 쿼리가 예상대로 작동하고 필터링 중에 기록이 누락되지 않도록 할 수 있습니다.

글로벌 애플리케이션에서는 정확하고 안정적인 날짜 처리가 시간대에 관계없이 사용자에게 고품질 경험을 제공하는 데 핵심입니다.

최종 생각

날짜 및 시간대 처리로 인해 애플리케이션에서 예상치 못한 결과가 발생하는 유사한 상황을 경험한 적이 있습니까? 어떻게 해결하셨나요? 귀하의 경험, 피드백, 질문이나 우려 사항에 대해 듣고 싶습니다. 아래 댓글 섹션에서 자유롭게 공유해 주세요. 이 기사가 도움이 되었다면 좋아요를 누르고 혜택을 받을 수 있는 다른 사람들과 공유해 주세요!