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