// SQL Server 错误参考

SQL Server 错误 241:日期和/或时间转换失败

字符串无法转换为日期或时间:格式与会话的语言和 DATEFORMAT 设置不匹配,或者它根本不是有效日期。

错误编号
241
严重性
16
类别
数据转换与截断
错误信息
Conversion failed when converting date and/or time from character string.

它的意思

SQL Server 解析日期字符串的依据是格式和会话的 DATEFORMAT 和 LANGUAGE 设置。如果文本按该解释不是有效日期('31/12/2025' 在以月份为先的设置下, '2025-02-30', 'yesterday'),转换为 date, datetime 或者 datetime2 会报 241 错误。

常见原因

  • 模糊格式,例如 '03/04/2025' 或者 '31/12/2025',读取方式取决于 SET DATEFORMAT 以及登录的语言。
  • 不存在的日期,例如 2 月 30 日。
  • 在应该存放日期的列中出现的自由文本或空字符串。
  • 使用 CONVERT 而样式编号与字符串不匹配。

如何修复它

  1. 使用明确的 ISO 格式: '20251231' 或者 '2025-12-31T14:30:00'。无论语言和 DATEFORMAT 设置如何,这些的解析结果都相同(在 datetime2 和 date, '2025-12-31' 也是安全的)。

    SELECT CAST('20251231' AS date), CAST('2025-12-31T14:30:00' AS datetime2);
  2. 使用显式样式解析已知格式。样式 103 是 dd/mm/yyyy,样式 101 是 mm/dd/yyyy。

    SELECT CONVERT(date, '31/12/2025', 103);
  3. 找出错误值可以用 TRY_CONVERT.

    SELECT RawDate FROM staging.Events WHERE TRY_CONVERT(date, RawDate, 103) IS NULL AND RawDate IS NOT NULL;
  4. 从应用程序传递日期时使用类型化参数(date, datetime2),而绝不会是格式化后的字符串。

安全地复现它

SET DATEFORMAT mdy;
SELECT CAST('31/12/2025' AS date);  -- Msg 241

相关错误

更多数据转换和截断错误

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

// 错误更少,修复更快

在 SQLly 中使用 SQL Server

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