日期和时间规范函数
实体 SQL 包括日期和时间规范函数。
备注
下表显示了日期和时间实体 SQL 规范函数。 datetime 是一个 DateTime 值。
| 函数 | 说明 |
|---|---|
AddNanoseconds(expression,number) |
将指定的毫微秒 number 添加到 expression。参数 expression：DateTime、DateTimeOffset 或 Time。[.] 返回值 expression 的类型。 |
AddMicroseconds(expression,number) |
将指定的微秒 number 添加到 expression。参数 expression：DateTime、DateTimeOffset 或 Time。[.] 返回值 expression 的类型。 |
AddMilliseconds(expression,number) |
将指定的毫秒 number 添加到 expression。参数 expression：DateTime、DateTimeOffset 或 Time。[.] 返回值 expression 的类型。 |
AddSeconds(expression,number) |
将指定的秒 number 添加到 expression。参数 expression：DateTime、DateTimeOffset 或 Time。[.] 返回值 expression 的类型。 |
AddMinutes(expression,number) |
将指定的分钟 number 添加到 expression。参数 expression：DateTime、DateTimeOffset 或 Time。[.] 返回值 expression 的类型。 |
AddHours(expression,number) |
将指定的小时 number 添加到 expression。参数 expression：DateTime、DateTimeOffset 或 Time。[.] 返回值 expression 的类型。 |
AddDays(expression,number) |
将指定的天 number 添加到 expression。参数 expression：DateTime 或 DateTimeOffset。[.] 返回值 expression 的类型。 |
AddMonths(expression,number) |
将指定的月份 number 添加到 expression。参数 expression：DateTime 或 DateTimeOffset。[.] 返回值 expression 的类型。 |
AddYears(expression,number) |
将指定的年份 number 添加到 expression。参数 expression：DateTime 或 DateTimeOffset。[.] 返回值 expression 的类型。 |
CreateDateTime(year,month,day,hour,minute,second) |
返回一个新的 DateTime 值作为服务器在自己的时区中的当前日期和时间。参数 year、month、day、hour、minute：Int16 和 Int32。[.] 返回值 一个 DateTime。 |
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) |
返回一个新的 DateTimeOffset 值作为服务器相对于协调世界时 (UTC) 的当前日期和时间。参数 [.] 返回值 一个 DateTimeOffset。 |
CreateTime(hour,minute,second) |
返回一个新的 Time 值作为当前时间。参数 hour 和 minute：Int32。[.] 返回值 一个 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 35Minute(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 5Second(cast('22:35:5' as DateTime)) |
TruncateTime(expression) |
返回截断了时间值的 expression。参数 DateTime 或 DateTimeOffset。返回值 expression 的类型。 |
Year(expression) |
将 expression 的年份部分作为 Int32 YYYY 返回。参数 DateTime 和 DateTimeOffset。返回值 Int32。示例 -- The following example returns 1998.Year(cast('03/12/1998' as DateTime)) |
如果提供 null 输入，则这些函数返回 null。
Microsoft SQL 客户端托管提供程序中提供了等效功能。 有关详细信息，请参阅实体框架函数的 SqlClient。