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

下表显示 Entity 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 值,该值作为服务器在 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。

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

 

返回值

Int32。

DiffMilliseconds( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(毫秒)。

参数

startExpression、endExpression:DateTime、DateTimeOffset 或 Time。

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

 

返回值

Int32。

DiffMicroseconds( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(微秒)。

参数

startExpression、endExpression:DateTime、DateTimeOffset 或 Time。

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

 

返回值

Int32。

DiffSeconds( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(秒)。

参数

startExpression、endExpression:DateTime、DateTimeOffset 或 Time。

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

 

返回值

Int32。

DiffMinutes( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(分钟)。

参数

startExpression、endExpression:DateTime、DateTimeOffset 或 Time。

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

 

返回值

Int32。

DiffHours( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(小时)。

参数

startExpression、endExpression:DateTime、DateTimeOffset 或 Time。

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

 

返回值

Int32。

DiffDays( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(天)。

参数

startExpression、endExpression:DateTime 或 DateTimeOffset。

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

 

返回值

Int32。

DiffMonths( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(月)。

参数

startExpression、endExpression:DateTime 或 DateTimeOffset。

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

 

返回值

Int32。

DiffYears( startExpression,endExpression)

返回 startExpression 和 endExpression 之间的差(年)。

参数

startExpression、endExpression:DateTime 或 DateTimeOffset。

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

 

返回值

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, 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))

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

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

http://msdn.microsoft.com/zh-cn/library/bb738563(v=vs.100).aspx

posted @ 2013-05-06 09:26  James·wang  阅读(708)  评论(0)    收藏  举报