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

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

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

22009 invalid_time_zone_displacement_value

ERROR 源码确认 参考 未实测

类别
Class 22 数据异常
严重等级
ERROR
条件名
invalid_time_zone_displacement_value
宏名称
ERRCODE_INVALID_TIME_ZONE_DISPLACEMENT_VALUE
启用版本
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

速览

固定 timetz_recv 二进制输入路径报告 time zone displacement out of range，表示 GMT 位移超过支持范围。

含义

已确认的 timetz_recv guard 会把收到的 GMT 位移与 PostgreSQL 支持的上限比较；这是二进制输入契约错误，不是一般 session TimeZone 设置错误。

报文

已确认的 guard 以 ERROR 严重性报告 primary：time zone displacement out of range。该源码路径没有固定 DETAIL 或 HINT。本页只有源码证据，没有自然运行观察。

报文模板

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

主消息 time zone displacement out of range

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

诊断

保留实际收到的 offset 数值，检查提供该值的二进制 timetz 接收器或协议解码器，区分位移越界、一般 datetime 字段越界和 session TimeZone 设置问题。

处置

在提供该值的客户端或二进制输入边界校验并替换位移；只有输入契约支持时才改用具有预期语义的命名时区。这是 ERROR：显式事务中要回滚整个事务，或回滚到失败转换前建立的保存点后再继续。本页没有运行案例。

版本

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

来源

证据

断言

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

  • 22009 is invalid_time_zone_displacement_value in SQLSTATE Class 22.

    核实方式Read fixed definition.

    来源src/backend/utils/errcodes.txt

  • The date/time binary receive path checks the GMT displacement against the supported TZDISP_LIMIT and emits 22009 when it is outside that range.

    核实方式Read the complete displacement guard.

    不覆盖This is a displacement-range error, distinct from malformed date text or session TimeZone configuration.

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

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

    核实方式Use catalogue boundary.

    来源src/backend/utils/errcodes.txt

同类错误代码

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