↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / 错误代码 / Class 22 数据异常

22008 datetime_field_overflow

ERROR 源码确认 参考 未实测

类别
Class 22 数据异常
严重等级
ERROR
条件名
datetime_field_overflow
宏名称
ERRCODE_DATETIME_FIELD_OVERFLOW ERRCODE_DATETIME_VALUE_OUT_OF_RANGE ERRCODE_DATETIME_VALUE_OUT_OF_RANGE
启用版本
7.4
状态
活跃

版本覆盖

  1. 18
  2. 17
  3. 16
  4. 15
  5. 14
  1. 13
  2. 12
  3. 11
  4. 10
  1. 19 beta
  2. 20 dev

速览

固定 date.c 路径报告日期值、日期字段和时间字段越界；具体 primary 会说明失败的转换或操作。

含义

已确认的 date.c 路径覆盖 date 输入/二进制接收、make_date 字段和范围校验，以及 make_time 字段校验。date 到 timestamp 的转换和算术路径可能使用各自的范围报文；应先看完整 primary 再决定修复。

报文

已确认的 guard 以 ERROR 严重性报告 primary 模板 date out of range、date out of range: %d-%02d-%02d 和 time field value out of range: %d:%02d:%02g。引用的源码组没有独立 DETAIL 或 HINT。本页只有源码证据，没有自然运行观察。

报文模板

源码里的格式串，不是某一次运行的输出。%s 之类是占位符，实际报文会填入对象名与取值。适用范围一栏是核验时留下的原始英文记录，未经翻译。

主消息 date out of range

来源：src/backend/utils/adt/date.c @ REL_18_6

主消息 date field value out of range: %d-%02d-%02d

来源：src/backend/utils/adt/date.c @ REL_18_6

主消息 time field value out of range: %d:%02d:%02g

来源：src/backend/utils/adt/date.c @ REL_18_6

诊断

保留日期字段、目标 datetime 类型，以及操作是否解析日期文本或执行算术；若涉及 infinity，再记录是否执行了无限值运算。不要与 22007 的格式错误混淆。

处置

修正日期字段或选择可表示的有限范围；若完整消息指向 timestamp 转换或 infinity 运算，应明确修改该运算。这是 ERROR：显式事务中要回滚整个事务，或回滚到失败转换前建立的保存点后再继续。本页没有运行案例。

版本

锁定目录从 7.4 记录该条件，并在列出的正式快照及 19beta3 中出现；固定源码覆盖为 PostgreSQL 18.6。

来源

证据

断言

每条断言都写明了是怎么核实的，以及它不覆盖什么。这一层是核验时留下的原始英文记录，照原样呈现，未经翻译。

  • 22008 is datetime_field_overflow in SQLSTATE Class 22.

    核实方式Read fixed definition.

    来源src/backend/utils/errcodes.txt

  • The date input/binary receive and field validation paths use 22008 for an unrepresentable date or field; the primary wording identifies whether the failure is a field or range check.

    核实方式Read date.c range guards.

    不覆盖This page does not claim every timestamp or interval overflow uses the same message.

    来源src/backend/utils/adt/date.c · src/backend/utils/adt/date.c

  • The make_time path uses the same condition for an out-of-range time field.

    核实方式Read the time-field guard.

    不覆盖Inspect the named target type and operation before choosing a repair.

    来源src/backend/utils/adt/date.c

  • The locked catalogue records 22008 from 7.4 without proving an exact implementation introduction date.

    核实方式Use catalogue boundary.

    来源src/backend/utils/errcodes.txt

同类错误代码

Class 22 数据异常 下的其他成员。