Menu

PostgreSQL timestamp와 timestamptz 차이 (타임존 포함)

timestamptz는 시점을 저장하고 세션 타임존으로 보여 주며, timestamp는 타임존 없는 벽시계 시간을 저장합니다. 둘 다 입력한 타임존을 저장하지 않습니다. 거의 모든 경우에 timestamptz를 쓰세요.

이 페이지에는 실행 가능한 에디터가 있습니다. 편집하고 실행하면 결과를 바로 볼 수 있습니다.

PostgreSQL에는 타임스탬프 타입이 두 가지 있습니다. timestamptz(timestamp with time zone)는 정확한 시점을 저장합니다. 입력할 때 UTC로 변환하고, 출력할 때 세션 타임존으로 보여 줍니다. timestamp(timestamp without time zone)는 타임존 없이 날짜와 벽시계 시간만 저장합니다. 둘 다 입력한 타임존을 저장하지 않습니다. 어떤 시점에 일어난 일이라면 timestamptz를 쓰세요.

같은 입력이 2026-03-01 12:00:00과 2026-03-01 21:00:00+09가 됩니다. timestamptz 값은 이전과 같은 시점이고, 지금은 도쿄 시간으로 표시됩니다. timestamp 값은 변환할 기준 타임존이 없으므로 움직이지 않습니다.

입력에 포함된 타임존의 처리

입력에 오프셋이 있으면 timestamptz는 그것으로 시점을 계산합니다. timestamp는 오프셋을 조용히 버립니다.

plain은 +02가 버려진 2026-03-01 12:00:00입니다. with_zone은 같은 시점을 UTC로 나타낸 2026-03-01 10:00:00+00입니다. 시간이 몇 시간씩 어긋나는 원인이 바로 이것입니다. 애플리케이션이 오프셋이 붙은 ISO 문자열을 timestamp 컬럼에 보내면 오프셋이 사라집니다.

타입별 용도

용도타입
생성, 수정, 결제, 로그인 시각timestamptz
현지 시계를 따르는 예약 시간("사용자 타임존 기준 매일 9:00")timestamp와 타임존 이름 컬럼
시간 없는 날짜date
시간의 길이interval

두 타입 모두 8바이트를 쓰고 마이크로초까지 저장합니다. 세션 타임존은 SET TIME ZONE 'Europe/Paris'로 설정합니다. EST 같은 약어가 아니라 전체 타임존 이름을 쓰세요. 약어는 서머타임을 무시하는 고정 오프셋입니다.

AT TIME ZONE으로 타임존 변환하기

AT TIME ZONE은 양방향으로 동작합니다. timestamptz에 쓰면 그 타임존의 벽시계 시간을 timestamp로 돌려줍니다. timestamp에 쓰면 값을 그 타임존의 현지 시간으로 읽어 timestamptz 시점을 돌려줍니다.

7월의 UTC 정오는 뉴욕에서 08:00이고, 파리의 9:00은 UTC로 07:00입니다. 첫 번째 형태는 사용자 타임존으로 시간을 보여 줄 때, 두 번째 형태는 사용자가 입력한 현지 시간을 시점으로 바꿀 때 씁니다.

서머타임과 interval 연산

timestamptz에 interval '1 day'를 더하면 서머타임이 바뀌어도 같은 현지 시각이 유지됩니다. '24 hours'를 더하면 정확히 그만큼의 시간이 더해집니다. 미국에서는 2026년 3월 8일에 시계가 앞당겨집니다.

첫 번째는 2026-03-08 12:00:00-04, 두 번째는 2026-03-08 13:00:00-04입니다. 결과가 세션 타임존에 따라 달라지므로, 날짜 연산을 하는 코드에서는 타임존을 명시적으로 설정하세요.

현재 시각

now()와 current_timestamp는 현재 트랜잭션의 시작 시각을 timestamptz로 돌려주며, 한 문장이 건드리는 모든 행에서 같은 값입니다. clock_timestamp()는 호출할 때마다 실제 시각을 돌려줍니다. current_date는 date를, localtimestamp는 timestamp를 돌려줍니다. 흔히 쓰는 컬럼은 created_at timestamptz NOT NULL DEFAULT now()입니다.

timestamp 컬럼을 timestamptz로 바꾸기

기존 timestamp 컬럼에 UTC 시간이 들어 있다면 USING ... AT TIME ZONE 'UTC'로 변환하세요. 그래야 값이 세션 타임존이 아니라 UTC로 읽힙니다.

이제 값은 베를린 시간으로 표시된 2026-01-15 09:30:00+01입니다. 이 변경은 테이블을 다시 쓰므로, 큰 테이블이라면 한가한 시간에 실행하세요(타입 변경은 ALTER TABLE에서 다룹니다). date_trunc, extract, age 같은 함수는 날짜 함수 페이지에 있고, 전체 입력 형식은 날짜/시간 타입 장에 있습니다.

자주 묻는 질문

PostgreSQL의 timestamptz는 타임존을 저장하나요?

아니요. 입력을 UTC로 변환해 그 시점만 저장합니다. 입력한 타임존은 사라지고, 출력은 세션의 TimeZone 설정으로 표시됩니다. 나중에 타임존이 필요하다면 별도 text 컬럼에 타임존 이름을 저장하세요.

now()와 clock_timestamp()는 무엇이 다른가요?

now()(current_timestamp와 같음)는 현재 트랜잭션의 시작 시각을 돌려주므로, 그 트랜잭션 안의 모든 행과 문장에서 같은 값입니다. clock_timestamp()는 호출한 순간의 실제 시각을 돌려주며, 한 문장 안에서도 값이 바뀝니다.

PostgreSQL에서 오늘 날짜는 어떻게 구하나요?

current_date는 세션 타임존 기준의 오늘 날짜를 돌려줍니다. now()::date도 같은 결과를 주고, localtimestamp는 현재 날짜와 시간을 타임존 없는 timestamp로 돌려줍니다.

PostgreSQL에서 timestamp는 공간을 얼마나 차지하나요?

timestamp와 timestamptz 모두 8바이트이며 마이크로초 단위까지 저장합니다. date는 4바이트입니다.

Coddy 프로그래밍 언어 일러스트

Coddy로 코딩 배우기

시작하기