// PostgreSQL 錯誤參考
PostgreSQL 22008:日期/時間欄位值超出範圍
日期或時間的某個欄位超出有效範圍,例如 13 月、30 天的月份裡出現 31 日,或日和月的順序寫反了。
- SQLSTATE
22008- 名稱
datetime_field_overflow- 類別
- 資料異常
它的意義
輸入的內容看似日期或時間,但其中一個欄位不可能存在:月份超過 12、該月不存在的日期、小時超過 24。22008(datetime_field_overflow)也涵蓋超出可表示範圍的結果,例如 timestamp out of range.
當值是數字日期時,例如 13/01/2026,PostgreSQL 會新增一個提示,指出你可能需要不同的 DateStyle,因為它將 13 讀作月份。
常見原因
- 日與月對調,起因於工作階段的
DateStyle. - 來源資料中存在無效的日期,例如 2 月 30 日。
- 日期運算產生了超過支援範圍的值。
如何修正
-
使用 ISO 8601 日期(
YYYY-MM-DD),這些日期從不會產生歧義。 -
如果資料是日在前、月在後的格式,請明確說明,或使用明確的格式來解析。
SET DateStyle = 'ISO, DMY'; SELECT '13/01/2026'::date; -- or SELECT to_date('13/01/2026', 'DD/MM/YYYY'); -
在轉換之前,先找出暫存資料表中的錯誤資料列(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 和你使用的其他資料庫。