// PostgreSQL エラーリファレンス

PostgreSQL 22008: 日付/時刻フィールドの値が範囲外です

日付または時刻に、有効範囲外のフィールドがありました。たとえば 13 月、30 日しかない月の 31 日、日と月の順序の取り違えなどです。

SQLSTATE
22008
名前
datetime_field_overflow
カテゴリ
データ例外
エラーメッセージ
date/time field value out of range: "2026-13-01"

意味

入力は日付または時刻のように見えますが、そのフィールドの 1 つが不可能な値です。12 を超える月、その月に存在しない日、24 を超える時などです。22008(datetime_field_overflow) は、次のような表現可能な範囲外の結果も対象とします: timestamp out of range.

値が次のような数値の日付である場合 13/01/2026、PostgreSQL は、別のものが必要かもしれないというヒントを追加します。 DateStyle、13 を月として読み取ったためです。

よくある原因

  • 日と月が入れ替わる原因は、セッションの DateStyle.
  • ソースデータにある、2 月 30 日のような実在しない日付。
  • サポートされている範囲を超える値を生成する日付演算。

修正方法

  1. ISO 8601 形式の日付を使用する(YYYY-MM-DD)。これらはあいまいになることがありません。

  2. データが日を先頭とする形式の場合は、その旨を指定するか、明示的な書式で解析してください。

    SET DateStyle = 'ISO, DMY';
    SELECT '13/01/2026'::date;
    -- or
    SELECT to_date('13/01/2026', 'DD/MM/YYYY');
  3. 変換前に、ステージングテーブル内の不正な行を見つけます(PostgreSQL 16 以降)。

    SELECT raw_date FROM staging WHERE NOT pg_input_is_valid(raw_date, 'date');

安全に再現する

SELECT '2026-02-30'::date;  -- ERROR: date/time field value out of range: "2026-02-30"

関連エラー

その他のデータ例外のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。