日期及時間標準函式

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)	以介於 1 到 31 之間的 expression 格式傳回 Int32 的日數部分。 引數 DateTime 和 DateTimeOffset。 傳回值 Int32。 範例 -- The following example returns 12. Day(cast('03/12/1998' as DateTime))
DayOfYear(expression)	以介於 1 到 366 之間的 expression 格式傳回的 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)	以介於 0 到 23 之間的 expression 格式傳回 Int32 的小時部分。 引數 DateTime, Time 和 DateTimeOffset。 範例 -- The following example returns 22. Hour(cast('22:35:5' as DateTime))
Millisecond(expression)	以介於 0 到 999 之間的 expression 格式傳回 Int32 的毫秒部分。 引數 DateTime, Time 和 DateTimeOffset。 傳回值 Int32。
Minute(expression)	以介於 0 到 59 之間的 expression 格式傳回 Int32 的分鐘部分。 引數 DateTime, Time 或 DateTimeOffset。 傳回值 Int32。 範例 -- The following example returns 35 Minute(cast('22:35:5' as DateTime))
Month(expression)	以介於 1 到 12 之間的 expression 格式傳回 Int32 的月份部分。 引數 DateTime 或 DateTimeOffset。 傳回值 Int32。 範例 -- The following example returns 3. Month(cast('03/12/1998' as DateTime))
Second(expression)	以介於 0 到 59 之間的 expression 格式傳回 Int32 的秒鐘部分。 引數 DateTime, Time 和 DateTimeOffset。 傳回值 Int32。 範例 -- The following example returns 5 Second(cast('22:35:5' as DateTime))
TruncateTime(expression)	傳回 expression，含已截斷的時間值。 引數 DateTime 或 DateTimeOffset。 傳回值 expression 的類型。
Year(expression)	以 Int32YYYY 格式傳回 expression。 引數 DateTime 和 DateTimeOffset。 傳回值 Int32。 範例 -- The following example returns 1998. Year(cast('03/12/1998' as DateTime))

如果提供 null 輸入，這些函式會傳回 null。

Microsoft SQL Client Managed Provider 中提供了對等的功能。 如需詳細資訊，請參閱 Entity Framework 函式中的 SqlClient。

另請參閱

• 標準函式