DATETIMEFROMPARTS 仅适用于 SQL Server 2012 及以上版本,要求严格按年、月、日、时、分、秒、毫秒顺序传入整数参数,NULL 值对应部分默认为 0,非法值或类型不匹配将报错,且不支持时区处理。

DATETIMEFROMPARTS 在 SQL Server 中是否可用
只有 SQL Server 2012 及更高版本支持 DATETIMEFROMPARTS。低于 2012 的版本(如 2008 R2)会报错 Invalid object name 'DATETIMEFROMPARTS',不能用该函数替代 DATEADD + CONVERT 的组合。
参数顺序和类型必须严格匹配
DATETIMEFROMPARTS 要求按固定顺序传入年、月、日、时、分、秒、毫秒(最后两个参数可为 NULL),且所有非 NULL 参数必须是整数类型(int 或可隐式转为 int 的值)。传入字符串或小数会直接报错:Argument data type varchar is invalid for argument 1 of datetimefromparts function。
- 年份必须是 1–9999 之间的整数;0 或负数会报错
- 月份必须是 1–12;超出范围(如 13)报错
Failed to convert parameter value from a String to a Int32(实际是运行时验证失败) - 日期需合法(如 2023-02-30 会报错,不是静默截断)
- 时/分/秒/毫秒为
NULL时,对应部分默认为 0(不是当前时间)
示例正确用法:
SELECT DATETIMEFROMPARTS(2023, 12, 25, 14, 30, 45, 123); -- 返回 2023-12-25 14:30:45.123
与 DATETIME2FROMPARTS 的关键区别
如果目标列或变量是 DATETIME2 类型,用 DATETIMEFROMPARTS 会触发隐式转换,丢失精度(毫秒被截断为 .000/.003/.007)。此时应改用 DATETIME2FROMPARTS,它支持纳秒级精度(第 7 个参数是 nanoseconds,范围 0–999)。
-
DATETIMEFROMPARTS返回DATETIME(精度 3.33ms,范围 1753–9999) -
DATETIME2FROMPARTS返回DATETIME2(7)(默认精度 100ns,范围 0001–9999) - 混用会导致意外截断,比如
DATETIMEFROMPARTS(2023,1,1,0,0,0,999)返回2023-01-01 00:00:00.997(不是 .999)
拼接动态日期时注意 NULL 和边界校验
从表字段或变量拼接日期时,若任一参数为 NULL,整个结果就是 NULL——不会报错,但容易被忽略。例如:DATETIMEFROMPARTS(year_col, month_col, NULL, 0,0,0,0) 永远返回 NULL。
- 建议在调用前用
ISNULL或CASE显式处理空值,避免静默失败 - 对用户输入或外部数据,务必先验证月份/日期合法性,否则运行时报错会中断批处理
- 跨时区场景下,该函数不处理时区,纯按本地值构造;需要时区感知请用
AT TIME ZONE配合
常见误用:
SELECT DATETIMEFROMPARTS(YEAR(GETDATE()), MONTH(GETDATE()), DAY(@input_date), 0,0,0,0); -- 若 @input_date 为 NULL,结果全 NULL
毫秒精度、参数顺序、NULL 行为这三点最容易在迁移或动态构造逻辑里出问题,写之前最好用几个边界值快速验证一遍。










