Menu

PostgreSQL 日付関数:now・interval・date_trunc

PostgreSQL で日付を扱う方法。now() と current_date、interval による加算と減算、集計に使う date_trunc、extract と age、to_char での書式指定まで解説します。

このページのコードはエディタで実行できます。編集してすぐに結果を確認できます。

now() は現在の日付と時刻を、current_date は今日の日付を返します。どちらも interval でずらせます: now() - interval '30 days'。date_trunc('month', ts) はタイムスタンプをその月の初めに切り捨て、extract(year FROM ts) は1つのフィールドを取り出し、to_char(ts, 'YYYY-MM-DD') はテキストに整形します。

直近30日に入るのは注文 1 と 2 です。行は now() を基準に挿入されるので、表示される日付は実行したときによって変わります。

現在の日付と時刻を取得する

関数戻り値型
now(), current_timestampトランザクションが始まった日付と時刻timestamptz
current_date今日の日付date
localtimestampタイムゾーンなしの日付と時刻timestamp
clock_timestamp()呼び出した瞬間の実際の時刻timestamptz

now() はトランザクションの間ずっと変わらないので、1つのトランザクションで挿入した行はすべて同じタイムスタンプになります。長いトランザクションの中で各ステップの時間を測るには clock_timestamp() を使います。結果はセッションの TimeZone 設定によって変わります (timestamp と timestamptz の違い を参照)。

日付の足し算と引き算

結果は 2026-12-17、38、2026-02-28 00:00:00、2 days 08:30:00 です。ルールは次のとおりです。

  • date + integer と date - integer は日数だけ移動し、date を返します。
  • date - date は日数を整数で返します。
  • date + interval は timestamp を返します。日付にしたいなら ::date でキャストし直します。
  • timestamp - timestamp は interval を返します。
  • 1月31日に1か月足すと2月28日 (または29日) になります。PostgreSQL は短い月の月末日に合わせます。

interval は interval '2 hours 15 minutes' や interval '1 year' のように書きます。列の値を日数として使うなら interval '1 day' * n か make_interval(days => n) を使います。

date_trunc で月、週、日ごとに集計する

date_trunc(unit, value) はタイムスタンプを year、quarter、month、week (月曜始まり)、day、hour、minute の初めに切り捨てます。これで GROUP BY すると、期間ごとに行を数えられます。

9月は2件、10月と11月は1件ずつです。注文のない月は結果に出てきませんが、generate_series を使えば 0 で埋められます。

date に date_trunc を使うと timestamptz が返るので、日付に戻したいときは ::date を付けます。15分刻みのような任意の幅で区切るには date_bin (PostgreSQL 14 以降) を使います。

フィールドを取り出し、年齢を計算する

結果は 2026、2 (火曜日。日曜日が 0)、7200、36 years 3 mons 28 days、36 です。ほかに month、day、hour、quarter、week (ISO 週番号)、isodow (月曜日が 1)、epoch (タイムスタンプなら1970年からの秒数) などのフィールドがあります。

PostgreSQL 14 以降の extract は numeric を返します。古い date_part('year', d) は double precision を返します。

age(a, b) は年、月、日での差を返すので、人の年齢を求めるのに向いています。引数1つの age(ts) は current_date からの差を測ります。

to_char で日付を整形し、to_date で解析する

最初の2つは 2026-11-17 14:05:09 と Tuesday, 17 Nov 2026 を返します。to_date と to_timestamp は、指定したパターンでテキストを読み取ります。よく使うパターンは次のとおりです。

コード意味コード意味
YYYY4桁の年HH24時 (00〜23)
MM月 (01〜12)HH12, AM12時間制
DD日MI分
Mon, Month月の名前SS秒
Dy, Day曜日の名前FM空白で埋めない (接頭辞)

FM がないと、Day と Month は空白で9文字に埋められます。MM は月、MI は分で、取り違えやすい組み合わせです。数値1つを渡す to_timestamp(1763337600) は Unix エポック値を変換します。

よくある質問

PostgreSQL で2つの日付の間の日数を求めるには?

date 型として引き算します。date '2026-12-25' - date '2026-11-17' は整数の 38 を返します。2つのタイムスタンプを引き算すると、代わりに 2 days 08:30:00 のような interval が返ります。

now() と current_timestamp の違いは何ですか?

違いはありません。どちらも現在のトランザクションの開始時刻を timestamptz で返します。clock_timestamp() は呼び出した瞬間の実際の時刻を返し、1つの文の中でも変わります。

PostgreSQL で昨日の日付を取得するには?

current_date - 1 です。date に整数を足したり引いたりすると、その日数だけ移動し、型は date のままです。

PostgreSQL で月末日を取得するには?

月の初めに切り捨て、1か月足して1日戻します: (date_trunc('month', d) + interval '1 month - 1 day')::date。

Coddyのプログラミング言語のイラスト

Coddyでコードを学ぼう

始める