// SQL Server 错误参考

SQL Server 错误 242:超出范围的日期转换

一个值在日期类型之间转换(通常是 varchar 转 datetime),结果超出了目标类型的范围,或本身不是有效日期。

错误编号
242
严重性
16
类别
数据转换与截断
错误信息
The conversion of a %ls data type to a %ls data type resulted in an out-of-range value.

它的意思

错误 242 表示转换能识别格式,但生成的日期存不进去。常见的一种情况是 datetime,它只覆盖 1753-01-01 到 9999-12-31,如果传入更早的日期,比如 0001-01-01 来自应用程序的默认日期值。另一个情况是日期格式中天或月超出范围,例如月为 13。

常见原因

  • 将诸如 '0001-01-01' 或一个 .NET DateTime.MinValue 变为 datetime,它的下限是 1753 年。
  • 日和月在会话的 DATEFORMAT,因此 '13/01/2025' 会被读成 13 月。
  • 将 datetime2 超出…的值 datetime 延伸到 datetime.

如何修复它

  1. 使用 datetime2,它覆盖 1 年到 9999 年且精度更高,用于新列。

    ALTER TABLE dbo.Events ALTER COLUMN OccurredAt datetime2(3) NOT NULL;
  2. 把应用程序的占位日期映射为 NULL,而不是存成公元 1 年。

  3. 使用 ISO 字符串或显式的 CONVERT 样式,因此日期和月份不能互换。

    SELECT CONVERT(datetime, '13/01/2025', 103);

安全地复现它

SELECT CAST('0001-01-01' AS datetime);  -- Msg 242

相关错误

更多数据转换和截断错误

代码和消息文本来自 Microsoft 数据库引擎事件和错误参考。浏览完整的 SQL Server 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 SQL Server 以及你使用的其他数据库。