// 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 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。