// PostgreSQL 錯誤參考

PostgreSQL 22008:日期/時間欄位值超出範圍

日期或時間的某個欄位超出有效範圍,例如 13 月、30 天的月份裡出現 31 日,或日和月的順序寫反了。

SQLSTATE
22008
名稱
datetime_field_overflow
類別
資料異常
錯誤訊息
date/time field value out of range: "2026-13-01"

它的意義

輸入的內容看似日期或時間,但其中一個欄位不可能存在:月份超過 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 和你使用的其他資料庫。