[JS] toISOString() 메서드 오프셋 교정하기 (UTC 시간대 변경)

Date.toISOString() 메서드는 Date 객체를 ISO 8601 형식의 UTC 시간으로 변환한다. 즉, 어떤 값이 들어오든 항상 UTC+0 시간으로 변환한 값을 반환한다는 의미다.

 

한국은 UTC 기준시보다 9시간(540분) 빠르기 때문에(+9시간) toISOString() 메서드가 반환하는 시간과 "표면적인" 차이가 발생한다. 예를들어 현재 한국 시간이 2022년 7월 8일 01시 56분이라면 toISOString 메서드는 이보다 9시간 늦은 2022-07-07T16:56... 를 반환한다.

// +09:00은 UTC 기준시 보다 9시간 빠르다는 것을 명시한 것
const localDate = new Date('2022-07-08T01:56:00+09:00');

// 출력값: 2022-07-07T16:56:00.000Z
// Z는 Zulu 시간대의 약어로 UTC+0과 동일
console.log(localDate.toISOString());

 

만약 로컬 시간대를 기반으로 ISO 8601 포맷의 문자열을 얻고 싶다면 별도의 유틸리티 함수를 만들어서 사용할 수 있다. 아래 함수는 로컬 시간대 오프셋을 계산하여 해당 시간대를 기준으로 한 ISO 문자열을 생성한다. 반환한 문자열엔 오프셋 정보를 그대로 포함하고 있기 때문에 필요에 따라 UTC 또는 다른 시간대로 변환할 수 있다.

const toLocaleISOString = (utcDate) => {
  // 로컬 시간대와 UTC 시간대의 차이를 분 단위로 반환
  // e.g. -540 (utcDate는 로컬 시간대보다 540분 느림)
  const offset = utcDate.getTimezoneOffset();

  // offset이 양수면 시간대 기호를 '-'로, 음수면 '+'로 설정
  const offsetSign = offset > 0 ? '-' : '+';

  // 숫자를 두 자리 문자열로 포매팅하는 함수 e.g. 2 => '02'
  const pad = (num) => String(num).padStart(2, '0');

  // 오프셋을 시간 단위로 변환 e.g. 540 / 60 = 9 => '09'
  const offsetHours = pad(Math.floor(Math.abs(offset) / 60));

  // 오프셋의 남은 분 계산 e.g. 540 % 60 -> '00'
  const offsetMinutes = pad(Math.abs(offset) % 60);

  // getTime() 메서드는 1970년 1월 1일 00:00:00 UTC 이후 경과된 시간을 밀리초 단위로 반환
  // 따라서 offset 값에도 60 * 1000을 곱해서 밀리초 단위로 만들어서 계산
  const localISOString = new Date(utcDate.getTime() - offset * 1000 * 60)
    .toISOString() // e.g. '2022-07-08T01:56:00.000Z'
    .slice(0, -1); // ISO 문자열에서 'Z' 제거 (Z는 Zulu 시간대의 약자로 UTC+0과 동일)

  return `${localISOString}${offsetSign}${offsetHours}:${offsetMinutes}`;
};

// 로컬 시간대 기반 ISO 문자열 출력 => '2022-07-08T01:56:00.000+09:00'
toLocaleISOString(new Date('2022-07-07T16:56:00.000Z'));