HOWTO · PostgreSQL
PostgreSQL에서 UTC 현재 시간을 기본값으로 사용하는 방법
UTC 현재 시각을 가져와 PostgreSQL 열의 기본값으로 사용하는 방법을 알아봅니다。
이 페이지의 내용
PostgreSQL에서 현재 시각을 UTC 기준 시계 시각으로 가져오려면 now() AT TIME ZONE 'UTC'를 사용합니다. INSERT에서 열을 생략했을 때 timestamp without time zone 열에 이 시각을 기본값으로 설정하려면 같은 표현식을 DEFAULT에 지정합니다. 값에는 날짜와 시각이 들어 있지만 시간대 표시는 없습니다. 열이 특정 시점을 나타내야 한다면 대신 timestamp with time zone을 사용하세요.
아래 SQL 예제는 설명을 위한 것이며 PostgreSQL 서버에서 실행하지 않았습니다. Python 예제는 UTC 시계 시각을 표현하는 방법을 결정적으로 보여 주며 PostgreSQL에 연결하지 않습니다.
PostgreSQL에서 현재 UTC 시각 가져오기
UTC 기준 시계 시각을 얻으려면 SELECT now() AT TIME ZONE 'UTC';를 실행합니다. PostgreSQL의 now()는 현재 트랜잭션이 시작된 시각을 반환하므로, 한 트랜잭션 안에서 여러 번 호출해도 같은 시점을 반환합니다. AT TIME ZONE 연산은 이 timestamp with time zone 시점을 날짜와 시각 필드가 UTC를 나타내는 timestamp without time zone 값으로 변환합니다. 결과 값 자체에는 시간대나 오프셋이 붙지 않습니다.
반면 SELECT now();는 timestamp with time zone을 반환합니다. PostgreSQL은 세션 시간대를 기준으로 이 시점을 표시하지만, 표시 방식이 시점 자체를 바꾸지는 않습니다. timestamp without time zone에는 날짜와 시각 필드만 저장됩니다. 시간대나 UTC 오프셋 메타데이터가 없으므로 그 자체로 UTC를 의미하지는 않습니다. 애플리케이션과 데이터베이스가 이 값을 UTC로 해석하기로 합의한 경우에만 UTC 시각을 저장하는 데 사용하세요.
테이블 열의 UTC 타임스탬프 기본값 설정
UTC 기준 시계 시각을 저장할 열은 timestamp without time zone으로 정의하고 DEFAULT (now() AT TIME ZONE 'UTC')를 지정합니다. 예를 들어 SQL 표현식은 CREATE TABLE event_log (created_at timestamp without time zone DEFAULT (now() AT TIME ZONE 'UTC'), event_name text);입니다. 기본값 표현식의 괄호는 생략해도 됩니다.
예를 들어 INSERT INTO event_log (event_name) VALUES ('started');처럼 created_at을 생략해 행을 삽입하면 PostgreSQL이 해당 열의 기본값을 계산합니다. created_at에 값을 명시하면 그 값이 기본값보다 우선합니다. 기본값은 삽입할 때 적용되며 이후에 자동으로 갱신되지 않습니다. now()는 트랜잭션 시작 시각으로 고정되므로, 같은 트랜잭션에서 삽입한 행은 같은 타임스탬프를 받습니다. 여러 클라이언트에서 동일한 시점을 나타내야 하는 이벤트 데이터에는 일반적으로 timestamp with time zone이 더 적합합니다. 각 세션은 이 시점을 자체 시간대에 맞춰 표시할 수 있습니다.
현재 시각을 UTC로 변환하기
같은 변환을 함수 형태로 쓰면 timezone('UTC', now())입니다. PostgreSQL의 timezone()은 시간대와 타임스탬프 값을 받습니다. now()와 함께 사용하면 UTC 기준 시점을 나타내는 timestamp without time zone을 반환합니다. 이는 타임스탬프 변환이며 TIME 유형으로 변환하는 것이 아닙니다. AT TIME ZONE 형태를 사용하면 표현식에서 변환 방향을 더 분명하게 볼 수 있습니다.
고정된 시점을 사용하면 시점과 UTC 기준 시계 시각의 차이를 구체적으로 확인할 수 있습니다. 다음 Python 예제는 표준 라이브러리를 사용해 시간대 표시가 없는 타임스탬프를 출력합니다.
from datetime import datetime, timezone
instant = datetime(2026, 10, 23, 12, 0, tzinfo=timezone.utc)
utc_clock_reading = instant.astimezone(timezone.utc).replace(tzinfo=None)
print(utc_clock_reading.isoformat(sep=" "))
2026-10-23 12:00:00
이 예제는 SQL 표현식이 만드는 값의 형태를 보여 줍니다. Python 코드는 SQL을 실행하지 않습니다. UTC 변환 대신 now()::timestamp를 사용하지 마세요. timestamp with time zone을 timestamp without time zone으로 캐스팅하면 세션 시간대가 적용되므로 시각 필드는 해당 설정에 따라 달라집니다. timezone(INTERVAL '+00:00', now()) 형태도 오프셋 0을 사용해 UTC 기준 시계 시각을 반환합니다. INTERVAL '-08:00'처럼 0이 아닌 오프셋은 다른 시계 시각을 나타냅니다.
재사용 가능한 UTC 기본값에 SQL 함수 사용하기
여러 테이블 정의에서 같은 표현식이 필요하다면, 선택적으로 SQL 함수를 만들어 재사용 가능한 이름을 부여할 수 있습니다. 반환 유형을 timestamp without time zone으로 지정합니다. 예를 들면 CREATE FUNCTION current_utc_timestamp() RETURNS timestamp without time zone LANGUAGE sql STABLE AS 'SELECT now() AT TIME ZONE ''UTC''';입니다. 그런 다음 열 정의에 DEFAULT current_utc_timestamp()를 사용하세요.
이 함수는 표현식을 하나로 묶어 재사용하게 해 줄 뿐, 트랜잭션 내에서 시계가 계속 진행되도록 하거나 반환 유형을 바꾸지는 않습니다. 직접 기본값을 지정하는 경우와 마찬가지로, 이 함수를 사용하는 열은 행을 삽입할 때 해당 열의 값을 지정하지 않은 경우에만 값을 받습니다. 데이터의 의미에 맞는 유형을 선택하세요. 관례에 따라 UTC로 해석하는 UTC 기준 시계 시각에는 timestamp without time zone을 사용하고, 특정 시점을 저장할 때는 일반적으로 timestamp with time zone을 사용합니다.