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

Entity SQL 提供日期和时间规范函数。 

备注

下表显示 Entity SQL 日期和时间规范函数。datetimeDateTime 值。

功能 说明

AddNanoseconds( expression,number)

将指定的毫微秒 number 添加到 expression

参数

expressionDateTimeDateTimeOffsetTime

number: Int32.

返回值

expression 的类型。

AddMicroseconds( expression,number)

将指定的微秒 number 添加到 expression

参数

expressionDateTimeDateTimeOffsetTime

number: Int32.

返回值

expression 的类型。

AddMilliseconds( expression,number)

将指定的毫秒 number 添加到 expression

参数

expressionDateTimeDateTimeOffsetTime

number: Int32.

返回值

expression 的类型。

AddSeconds( expression,number)

将指定的秒 number 添加到 expression

参数

expressionDateTimeDateTimeOffsetTime

number: Int32.

返回值

expression 的类型。

AddMinutes( expression,number)

将指定的分钟 number 添加到 expression

参数

expressionDateTimeDateTimeOffsetTime

number: Int32.

返回值

expression 的类型。

AddHours( expression,number)

将指定的小时 number 添加到 expression

参数

expressionDateTimeDateTimeOffsetTime

number: Int32.

返回值

expression 的类型。

AddDays( expression,number)

将指定的天 number 添加到 expression

参数

expressionDateTimeDateTimeOffset

number: Int32.

返回值

expression 的类型。

AddMonths( expression,number)

将指定的月份 number 添加到 expression

参数

expressionDateTimeDateTimeOffset

number: Int32.

返回值

expression 的类型。

AddYears( expression,number)

将指定的年度 number 添加到 expression

参数

expressionDateTimeDateTimeOffset

number: Int32.

返回值

expression 的类型。

CreateDateTime( year, month, day, hour, minute, second)

返回一个新的 DateTime 值,该值作为服务器在自己的时区中的当前日期和时间。

参数

yearmonthdayhourminuteInt16Int32

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 值作为当前时间。

参数

hourminuteInt32

second: Double.

返回值

一个 Time

CurrentDateTime()

返回一个 DateTime 值,该值作为服务器在自己的时区中的当前日期和时间。

返回值

一个 DateTime

CurrentDateTimeOffset()

将当前日期、时间和偏移量作为 DateTimeOffset 返回。

返回值

一个 DateTimeOffset

CurrentUtcDateTime()

返回一个 DateTime 值,该值作为服务器在 UTS 时区中的当前日期和时间。

返回值

一个 DateTime

Day( expression )

expression 的日期部分作为介于 1 到 31 之间的 Int32 返回。

参数

DateTimeDateTimeOffset

返回值

Int32

示例

-- The following example returns 12.

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

DayOfYear( expression )

返回 expression 的日期部分,作为 1 到 366 之间的一个 Int32,其中 366 为闰年的最后一天返回。

参数

DateTimeDateTimeOffset

返回值

Int32

DiffNanoseconds( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(毫微秒)。

参数

startExpressionendExpressionDateTimeDateTimeOffsetTime

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffMilliseconds( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(毫秒)。

参数

startExpressionendExpressionDateTimeDateTimeOffsetTime

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffMicroseconds( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(微秒)。

参数

startExpressionendExpressionDateTimeDateTimeOffsetTime

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffSeconds( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(秒)。

参数

startExpressionendExpressionDateTimeDateTimeOffsetTime

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffMinutes( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(分钟)。

参数

startExpressionendExpressionDateTimeDateTimeOffsetTime

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffHours( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(小时)。

参数

startExpressionendExpressionDateTimeDateTimeOffsetTime

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffDays( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(天)。

参数

startExpressionendExpressionDateTimeDateTimeOffset

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffMonths( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(月)。

参数

startExpressionendExpressionDateTimeDateTimeOffset

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

DiffYears( startExpression,endExpression)

返回 startExpressionendExpression 之间的差(年)。

参数

startExpressionendExpressionDateTimeDateTimeOffset

Bb738563.note(zh-cn,VS.100).gif注意:
startExpressionendExpression 必须属于同一类型。

返回值

Int32

GetTotalOffsetMinutes( datetimeoffset )

返回 datetimeoffset 相对于 GMT 偏移的分钟数。 该值通常介于 +780 到 -780 之间(+ 或 - 13 小时)。

Bb738563.note(zh-cn,VS.100).gif注意:
只有 SQL Server 2008 支持此函数。

参数

一个 DateTimeOffset

返回值

Int32

Hour ( expression )

expression 的小时部分作为介于 0 到 23 之间的 Int32 返回。

参数

DateTime, TimeDateTimeOffset

示例

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))

Millisecond( expression )

expression 的毫秒部分作为介于 0 到 999 之间的 Int32 返回。

参数

DateTime, TimeDateTimeOffset

返回值

Int32

Minute( expression )

expression 的分钟部分作为介于 0 到 59 之间的 Int32 返回。

参数

DateTime, TimeDateTimeOffset

返回值

Int32

示例

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))

Month (expression)

expression 的月份部分作为介于 1 到 12 之间的 Int32 返回。

参数

DateTimeDateTimeOffset

返回值

Int32

示例

-- The following example returns 3.

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

Second( expression )

expression 的秒部分作为介于 0 到 59 之间的 Int32 返回。

参数

DateTime, TimeDateTimeOffset

返回值

Int32

示例

-- The following example returns 5

Second(cast('22:35:5' as DateTime))

Truncate( expression )

返回截断了时间值的 expression

参数

DateTimeDateTimeOffset

返回值

expression 的类型。

Year( expression )

expression 的年度部分作为 Int32 YYYY 返回。

参数

DateTimeDateTimeOffset

返回值

Int32

示例

-- The following example returns 1998.

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

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

Microsoft SQL 客户端托管提供程序中提供了等效功能。 有关更多信息,请参见 用于实体框架函数的 SQL Server .NET Framework 数据提供程序 (SqlClient)

另请参见

概念

规范函数 (Entity SQL)