日期和时间规范函数 (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。 注意： 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))

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

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

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