読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 日付・時刻とNULL

2.1 時差付きの日時の型

予約の表の、日時の列は次のように作ります。

CREATE TABLE reservations (
  id text PRIMARY KEY,
  user_id integer NOT NULL REFERENCES users (id),
  name text NOT NULL,
  pickup_at timestamp with time zone NOT NULL,
  status text NOT NULL CHECK (status IN ('reserved', 'picked_up', 'cancelled')),
  created_at timestamp with time zone NOT NULL,
  picked_up_at timestamp with time zone,
  cancelled_at timestamp with time zone,
  ...
);

timestamp with time zone は、時差を含めて、ある瞬間を保存する型です。

SELECT '2026-11-02 08:00+09'::timestamptz AS a,
       '2026-11-02 08:00+00'::timestamptz AS b;
           a            |           b
------------------------+------------------------
 2026-11-02 08:00:00+09 | 2026-11-02 17:00:00+09

::timestamptz は、文字を時差付きの日時の型に直す書き方です(timestamptz は timestamp with time zone の短い書き方です)。+00 の8:00は、日本時間では17:00と表示されます。保存しているのは瞬間なので、表示する地域の時計に合わせて書き方が変わります。

列意味
pickup_at受け取りの日時
created_at予約を受け付けた日時
picked_up_at受け取った日時
cancelled_atキャンセルした日時

6 / 20