HOWTO · PostgreSQL
PostgreSQL で UTC の現在時刻をデフォルトとして使用する方法
UTC の現在時刻を取得し、PostgreSQL の列のデフォルトとして使用する方法を説明します。
このページの内容
PostgreSQLで現在時刻をUTCの日時として取得するには、now() AT TIME ZONE 'UTC'を使います。INSERT時に列が省略された場合に同じ値を設定するには、この式を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の値に変換します。変換後の値にはタイムゾーンやUTCオフセットは付いていません。
一方、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);です。デフォルト式を囲む括弧は省略できます。
created_atを省略して、たとえばINSERT INTO event_log (event_name) VALUES ('started');を実行すると、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を実行しません。now()::timestampをUTC変換の代わりに使わないでください。timestamp with time zoneをtimestamp without time zoneにキャストするときはセッションのタイムゾーンが使われるため、時刻フィールドはその設定によって変わります。timezone(INTERVAL '+00:00', now())という形式もゼロオフセットを使い、UTCの日時を返します。INTERVAL '-08:00'のようなゼロ以外のオフセットでは、別の日時になります。
再利用可能な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()を指定します。
この関数は式をまとめるものであり、トランザクション内で時刻が進むようにしたり、戻り値の型を変えたりするものではありません。直接デフォルト式を指定する場合と同様に、この関数を使う列の値は行の挿入時に設定され、INSERTでその列の値が省略された場合に限り適用されます。データの意味に合った型を選んでください。慣例によってUTCとして扱うUTC日時にはtimestamp without time zoneを使い、特定の時点を保存する場合は通常timestamp with time zoneを使います。