# 22008 — datetime_field_overflow

> PostgreSQL SQLSTATE 22008 的源码与诊断参考。
---

# 22008

## 速览 {#at-a-glance}

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

<!-- BEGIN SQLSTATE FACTS: generated by scripts/generate.py; do not edit -->

| 字段 | 值 |
| --- | --- |
| SQLSTATE | `22008` |
| 条件名 | `datetime_field_overflow` |
| 状态 | `有效` |
| 已知存在于 | `7.4` |
| 锁定快照 | `9.0.23, 9.1.24, 9.2.24, 9.3.25, 9.4.26, 9.5.25, 9.6.24, 10.23, 11.22, 12.22, 13.23, 14.24, 15.19, 16.15, 17.11, 18.6, 19beta3` |
| 宏 | `ERRCODE_DATETIME_FIELD_OVERFLOW, ERRCODE_DATETIME_VALUE_OUT_OF_RANGE` |
| 别名 | `ERRCODE_DATETIME_VALUE_OUT_OF_RANGE` |

<!-- source facts: data/errcodes/22008.json -->
<!-- END SQLSTATE FACTS -->

## 含义 {#meaning}

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

## 报文 {#messages}

已确认的 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。本页只有源码证据，没有自然运行观察。

## 诊断 {#diagnosis}

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

## 处置 {#response}

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


## 版本 {#versions}

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

## 相关条件 {#related}

[`22000`](../22000/), [`22001`](../22001/), [`22003`](../22003/), [`22004`](../22004/)

## 来源 {#sources}

详见结构化的[证据记录](../../data/evidence/22008.json)，其中列出固定源码链接与范围限制。