日期和时间规范函数 (Entity SQL)

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 值，该值作为服务器在 UTS 时区中的当前日期和时间。

返回值

一个 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))

Truncate( expression )

返回截断了时间值的 expression。

参数

DateTime 或 DateTimeOffset。

返回值

expression 的类型。

Year( expression )

将 expression 的年度部分作为 Int32YYYY 返回。

参数

DateTime 和 DateTimeOffset。

返回值

Int32。

示例

-- The following example returns 1998.

Year(cast('03/12/1998' as DateTime))