HOWTO · PostgreSQL

PostgreSQL - 今日を基準とした日付と時刻を確認する

この記事では、今日を基準とした現在の日付と時刻を確認する方法を示します。

このページの内容

現在のトランザクション開始時のタイムスタンプにはPostgreSQLのNOW()を、今日の日付だけが必要な場合にはCURRENT_DATEを使います。intervalを加算すれば基準時点からの日時を計算でき、日付のみの絞り込みにはCURRENT_DATEを使って日付同士を比較できます。以下の例ではPostgreSQLの関数名をそのまま示し、セッションのタイムゾーンやトランザクション境界が結果に与える影響を説明します。

NOW()で現在の日付と時刻を取得する

NOW()は、現在のトランザクションが始まった時点を表すtimestamp with time zone(timestamptzとも表記)を返します。たとえば、SELECT NOW();はある一時点を返します。PostgreSQLはセッションのTimeZone設定に従ってその一時点を表示するため、同じ一時点でもセッションによって時刻やオフセットが異なることがあります。ロサンゼルス時間で表示するには、選択する前にSET TIME ZONE 'America/Los_Angeles';でセッションのタイムゾーンを設定します。タイムゾーンを変えると一時点の表示は変わりますが、一時点そのものは変わりません。

タイムゾーンとタイムスタンプ型を理解する

timestamptzの値は一時点を表します。PostgreSQLは、値とともに指定された元の名前付きタイムゾーンを保持しません。セッションのTimeZoneは表示を制御し、ローカルのタイムゾーンが必要な変換にも影響します。NOW()::timestamp without time zone(またはNOW()::timestamp)のようにキャストすると、表示中のローカル時刻の各フィールドからタイムゾーン情報が取り除かれます。タイムゾーンなしでも同じ一時点が保たれるわけではありません。アプリケーションで必要なのがそのローカル時刻の各フィールドである場合に限り、このキャストを使ってください。

現在を基準に日付と時刻を計算する

interval演算を使うと、たとえばNOW() + interval '1 hour'でトランザクション開始時から1時間後、NOW() + interval '1 day'で翌日の同じローカル時刻、NOW() - interval '4 hours 15 minutes'で過去の時刻を求められます。タイムゾーンで夏時間への切り替えがあると、暦上の1日を加える計算と24時間を加える計算は異なることがあります。表したいルールに合う単位を選びましょう。

この例では、タイムゾーン付きのタイムスタンプが1時間進む様子を確認できます。

このセクションのコードと表示されるラベルや出力は英語のままです。

from datetime import datetime, timedelta, timezone

start = datetime(2026, 11, 6, 12, 0, tzinfo=timezone.utc)
print((start + timedelta(hours=1)).isoformat())
2026-11-06T13:00:00+00:00

このPythonの例はタイムスタンプの算術演算を示すもので、PostgreSQLを実行するものではありません。PostgreSQLのクエリでは、上記のNOW()とintervalの式を使います。

NOW()を列のデフォルト値に使う

CREATE TABLE文でcreated_at TIMESTAMPTZ DEFAULT NOW()を指定すると、タイムスタンプのデフォルト値を設定できます。その列に明示的な値を指定せずに行を挿入すると、PostgreSQLはその時点でデフォルト値を評価します。NOW()はトランザクション開始時点で固定されるため、同じトランザクション内で後から挿入した行にも、そのトランザクションの開始時刻が設定されることがあります。作成時刻に別の意味を持たせたい場合は、意図に合った時刻関数を選び、その動作を文書化してください。

PostgreSQLの現在時刻を表す値から選ぶ

CURRENT_TIMESTAMPはNOW()と同じで、トランザクション開始時点のタイムゾーン付きタイムスタンプを返します。CURRENT_TIMEは、タイムゾーンオフセットを含むトランザクション開始時点の時刻を返します。LOCALTIMESTAMPはタイムゾーンなしのトランザクション開始時点の日付と時刻を返し、LOCALTIMEはタイムゾーンなしのトランザクション開始時点の時刻を返します。これらのSQL標準の値は、NOW()と同様、現在のトランザクション中は変わりません。アプリケーションに一時点が必要なのか、ローカル時刻の各フィールドが必要なのかに応じて型を選びましょう。

CURRENT_DATEで日付を比較する

日付だけを条件にする場合は、WHERE dateval >= CURRENT_DATE - interval '1 year'を使うと、今日から1年前の日付以降のデータを選択できます。CURRENT_DATEは括弧を付けずに記述し、dateを返すため、日付列を時刻値と比較せずに済みます。タイムスタンプ列を使う場合は、境界をセッションのタイムゾーンにおける午前0時とするのか、特定の一時点とするのかを決め、比較の意味が明確になるようにしてください。dateとtimestamptzを比較すると、PostgreSQLはその日付を現在のセッションのタイムゾーンにおける午前0時として解釈します。

トランザクション時刻の挙動を理解する

NOW()、CURRENT_TIMESTAMP、CURRENT_DATE、CURRENT_TIME、LOCALTIMESTAMP、LOCALTIMEは、現在のトランザクション開始時点を基準にします。そのため、トランザクションが長時間続いても、同じトランザクション内で繰り返し呼び出すと同じ値が返ります。一方、TIMEOFDAYは異なり、現在の実時間を表すテキストを返すため、トランザクション中にも変化することがあります。計算や比較には型付きの現在時刻の値を使い、テキスト表現と変化する実時間が必要な場合に限ってTIMEOFDAYを使ってください。