SQL Academy · 강의

시간대: TIMESTAMP와 TIMESTAMPTZ

TIMESTAMP와 TIMESTAMPTZ의 차이를 이해하고 AT TIME ZONE으로 변환하며 이식 가능한 애플리케이션을 위해 UTC로 저장합니다.

레슨 3/413개 단계

시간대: TIMESTAMP와 TIMESTAMPTZ은(는) CoddyKit의 무료 SQL Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 SQL Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. SQL Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

두 가지 타임스탬프 유형

PostgreSQL에는 TWO가지 타임스탬프 유형이 있습니다.

TIMESTAMP — ‘순수’ 타임스탬프, 시간대 정보 없음
TIMESTAMPTZ — 시간대가 있는 타임스탬프(내부적으로 UTC로 저장됨)

일반적인 기준: 이벤트에는 TIMESTAMPTZ를, ‘오전 9시 영업 시간’처럼 순수하게 추상적인 시간에는 TIMESTAMP를 선호하십시오.

TIMESTAMPTZ의 작동 방식

내부적으로는 항상 UTC로 저장됩니다. INSERT할 때 입력값은 SESSION TZ에서 UTC로 변환됩니다. SELECT할 때 출력값은 다시 SESSION TZ로 변환됩니다.

SET TIME ZONE 'Europe/Berlin';
INSERT INTO events (ts) VALUES ('2024-03-15 12:00:00');
-- stored as 2024-03-15 11:00:00 UTC (Berlin is UTC+1 in winter)

SET TIME ZONE 'UTC';
SELECT ts FROM events;
-- 2024-03-15 11:00:00+00

TIMESTAMP는 정보가 손실됩니다

일반 TIMESTAMP는 시간대를 알 수 없습니다. ‘2024-03-15 12:00:00’은 어떤 현지 시간도 될 수 있습니다. 사용자가 시간대를 옮기면 의미가 손실됩니다.

AT TIME ZONE

표시를 위해 시간대 사이를 변환합니다.

SELECT ts AT TIME ZONE 'America/New_York' AS ny_time FROM events;
SELECT ts AT TIME ZONE 'Asia/Tokyo'        AS tokyo_time FROM events;

UTC 저장 및 현지 시간 표시

권장 방법은 TIMESTAMPTZ로 저장한 다음 SELECT에서 사용자의 시간대로 변환하는 것이며, 반대로 변환해서는 안 됩니다.

SELECT id,
       ts AT TIME ZONE COALESCE(u.tz, 'UTC') AS local_ts
FROM events e
JOIN users u ON u.id = e.user_id;

SESSION TIME ZONE

세션별, 사용자별 또는 전역으로 설정할 수 있습니다.

-- Session:
SET TIME ZONE 'Europe/Berlin';

-- Per-user (PG):
ALTER ROLE alice SET timezone TO 'Europe/Berlin';

-- Server default in postgresql.conf:
-- timezone = 'UTC'

SUPPLY ZONE WITH LITERAL

리터럴에 시간대를 포함합니다.

SELECT TIMESTAMPTZ '2024-03-15 12:00:00 Europe/Berlin';
SELECT '2024-03-15 12:00:00+02'::TIMESTAMPTZ;

NOW()는 TIMESTAMPTZ를 반환합니다

NOW()와 CURRENT_TIMESTAMP는 항상 TIMESTAMPTZ를 반환합니다. 이를 TIMESTAMP 열과 섞어 사용하는 것은 흔한 오류입니다.

TIMESTAMP(시간대 없음)가 적합한 경우

시간대에 실제로 의존하지 않는 추상적인 시간이나 현지 시간(‘매장이 09:00에 엽니다’)에는 TIMESTAMP(또는 TIME)를 사용하십시오.

CREATE TABLE store_hours (
  store_id BIGINT,
  open_at  TIME NOT NULL,
  close_at TIME NOT NULL
);

DST 전환

TIMESTAMPTZ는 DST를 자동으로 처리합니다. INTERVAL을 더하면 벽시계 기준 시간이 적용되지만 DST 경계를 넘을 때는 23시간 또는 25시간 차이가 날 수 있습니다.

SELECT TIMESTAMPTZ '2024-03-30 23:00:00 Europe/Berlin' + INTERVAL '5 hours';
-- Result accounts for the DST transition on March 31

오프셋 대신 시간대 이름 저장

+02:00 같은 오프셋만으로는 DST가 언제 시작되는지 알 수 없습니다. Europe/Berlin 같은 시간대 이름을 사용하면 알 수 있습니다. 사용자의 거주 시간대를 저장할 때는 IANA 이름을 저장하십시오.

복습

이벤트에는 TIMESTAMPTZ를 기본값으로 사용하십시오.

UTC로 저장하고 SESSION TZ에서 표시
표시할 때는 AT TIME ZONE으로 변환
추상적인 현지 시간에만 TIMESTAMP(시간대 없음) 사용

빠른 확인

전 세계 사용자를 대상으로 하는 SaaS에서 사용자 이벤트를 기록하려고 합니다. occurred_at 열에는 어떤 타임스탬프 유형을 사용해야 합니까?

인터랙티브 레슨에서 답해보세요

무료로 시작

AI 튜터와 함께 SQL을(를) 배우세요 — 무료

브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.

코스: 46
레슨: 183

무료로 학습 시작 전체 코스 보기

자주 묻는 질문

“시간대: TIMESTAMP와 TIMESTAMPTZ” 강의는 무료인가요?

네 — “시간대: TIMESTAMP와 TIMESTAMPTZ” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 SQL Academy 강의 전체를 잠금 해제할 수 있습니다. SQL Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“시간대: TIMESTAMP와 TIMESTAMPTZ”에서 뭘 배우나요?

TIMESTAMP와 TIMESTAMPTZ의 차이를 이해하고 AT TIME ZONE으로 변환하며 이식 가능한 애플리케이션을 위해 UTC로 저장합니다. 브라우저에서 직접 실행하는 실습 코드로 SQL Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

SQL Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 SQL Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.

“시간대: TIMESTAMP와 TIMESTAMPTZ” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 SQL Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 SQL Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← SQL Academy(으)로 돌아가기