日期和时间规范函数

实体 SQL 包括日期和时间规范函数。

备注

下表显示了日期和时间实体 SQL 规范函数。 datetime 是一个 DateTime 值。

函数	说明
AddNanoseconds(expression,number)	将指定的毫微秒 number 添加到 expression。 参数 expression：DateTime、DateTimeOffset 或 Time。 number: Int32。 返回值 expression 的类型。
AddMicroseconds(expression,number)	将指定的微秒 number 添加到 expression。 参数 expression：DateTime、DateTimeOffset 或 Time。 number: Int32。 返回值 expression 的类型。
AddMilliseconds(expression,number)	将指定的毫秒 number 添加到 expression。 参数 expression：DateTime、DateTimeOffset 或 Time。 number: Int32。 返回值 expression 的类型。
AddSeconds(expression,number)	将指定的秒 number 添加到 expression。 参数 expression：DateTime、DateTimeOffset 或 Time。 number: Int32。 返回值 expression 的类型。
AddMinutes(expression,number)	将指定的分钟 number 添加到 expression。 参数 expression：DateTime、DateTimeOffset 或 Time。 number: Int32。 返回值 expression 的类型。
AddHours(expression,number)	将指定的小时 number 添加到 expression。 参数 expression：DateTime、DateTimeOffset 或 Time。 number: Int32。 返回值 expression 的类型。
AddDays(expression,number)	将指定的天 number 添加到 expression。 参数 expression：DateTime 或 DateTimeOffset。 number: Int32。 返回值 expression 的类型。
AddMonths(expression,number)	将指定的月份 number 添加到 expression。 参数 expression：DateTime 或 DateTimeOffset。 number: Int32。 返回值 expression 的类型。
AddYears(expression,number)	将指定的年份 number 添加到 expression。 参数 expression：DateTime 或 DateTimeOffset。 number: Int32。 返回值 expression 的类型。
CreateDateTime(year,month,day,hour,minute,second)	返回一个新的 DateTime 值作为服务器在自己的时区中的当前日期和时间。 参数 year、month、day、hour、minute：Int16 和 Int32。 second: Double。 返回值 一个 DateTime。
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset)	返回一个新的 DateTimeOffset 值作为服务器相对于协调世界时 (UTC) 的当前日期和时间。 参数 year, month, day, hour, minute, tzoffset: Int32. second: Double。 返回值 一个 DateTimeOffset。
CreateTime(hour,minute,second)	返回一个新的 Time 值作为当前时间。 参数 hour 和 minute：Int32。 second: Double。 返回值 一个 Time。
CurrentDateTime()	返回一个 DateTime 值作为服务器所在时区中的当前日期和时间。 返回值 一个 DateTime。
CurrentDateTimeOffset()	将当前日期、时间和偏移量作为 DateTimeOffset 返回。 返回值 一个 DateTimeOffset。
CurrentUtcDateTime()	返回一个 DateTime 值，该值作为服务器在 UTC 时区中的当前日期和时间。 返回值 一个 DateTime。
Day(expression)	将 expression 的日部分作为一个介于 1 到 31 之间的 Int32 返回。 参数 DateTime 和 DateTimeOffset。 返回值 Int32。 示例 -- The following example returns 12. Day(cast('03/12/1998' as DateTime))
DayOfYear(expression)	将 expression 的日部分作为一个介于 1 到 366 之间的 Int32 返回，对于闰年的最后一天将返回 366。 参数 DateTime 或 DateTimeOffset。 返回值 Int32。
DiffNanoseconds(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（毫微秒）。 参数 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffMilliseconds(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（毫秒）。 参数 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffMicroseconds(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（微秒）。 参数 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffSeconds(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（秒）。 参数 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffMinutes(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（分钟）。 参数 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffHours(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（小时）。 参数 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffDays(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（天）。 参数 startExpression、endExpression：DateTime 或 DateTimeOffset。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffMonths(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（月）。 参数 startExpression、endExpression：DateTime 或 DateTimeOffset。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
DiffYears(startExpression,endExpression)	返回 startExpression 和 endExpression 之间的差（年）。 参数 startExpression、endExpression：DateTime 或 DateTimeOffset。 备注：startExpression 和 endExpression 必须属于同一类型。 返回值 Int32。
GetTotalOffsetMinutes(datetimeoffset)	返回 datetimeoffset 相对于 GMT 偏移的分钟数。 此值通常介于 +780 到 -780 之间（+ 或 - 13 小时）。 备注：只有 SQL Server 2008 支持此函数。 参数 一个 DateTimeOffset。 返回值 Int32。
Hour(expression)	将 expression 的小时部分作为一个介于 0 到 23 之间的 Int32 返回。 参数 DateTime, Time 和 DateTimeOffset。 示例 -- The following example returns 22. Hour(cast('22:35:5' as DateTime))
Millisecond(expression)	将 expression 的毫秒部分作为一个介于 0 到 999 之间的 Int32 返回。 参数 DateTime, Time 和 DateTimeOffset。 返回值 Int32。
Minute(expression)	将 expression 的分钟部分作为一个介于 0 到 59 之间的 Int32 返回。 参数 DateTime, Time 或 DateTimeOffset。 返回值 Int32。 示例 -- The following example returns 35 Minute(cast('22:35:5' as DateTime))
Month(expression)	将 expression 的月份部分作为一个介于 1 到 12 之间的 Int32 返回。 参数 DateTime 或 DateTimeOffset。 返回值 Int32。 示例 -- The following example returns 3. Month(cast('03/12/1998' as DateTime))
Second(expression)	将 expression 的秒部分作为一个介于 0 到 59 之间的 Int32 返回。 参数 DateTime, Time 和 DateTimeOffset。 返回值 Int32。 示例 -- The following example returns 5 Second(cast('22:35:5' as DateTime))
TruncateTime(expression)	返回截断了时间值的 expression。 参数 DateTime 或 DateTimeOffset。 返回值 expression 的类型。
Year(expression)	将 expression 的年份部分作为 Int32YYYY 返回。 参数 DateTime 和 DateTimeOffset。 返回值 Int32。 示例 -- The following example returns 1998. Year(cast('03/12/1998' as DateTime))

如果提供 null 输入，则这些函数返回 null。

Microsoft SQL 客户端托管提供程序中提供了等效功能。 有关详细信息，请参阅实体框架函数的 SqlClient。

请参阅

• 规范函数