日期和時間標準函式
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 之間的 Int32 格式傳回 expression 的日數部分。 引數 DateTime 和 DateTimeOffset。 傳回值 Int32。 範例
|
DayOfYear( expression ) |
以介於 1 到 366 之間的 Int32 格式傳回的 expression 天數部分，其中傳回的 366 代表閏年的最後一天。 引數 DateTime 或 DateTimeOffset。 傳回值 Int32。 |
DiffNanoseconds( startExpression, endExpression) |
傳回 startExpression 與 endExpression 之間的奈秒差。 引數 startExpression、endExpression：DateTime、DateTimeOffset 或 Time。 .gif "Bb738563.note(zh-tw,VS.100).gif") 注意：
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 之間的 Int32 格式傳回 expression 的小時部分。 引數 DateTime, Time 和 DateTimeOffset。 範例
|
Millisecond( expression ) |
以介於 0 到 999 之間的 Int32 格式傳回 expression 的毫秒部分。 引數 DateTime, Time 和 DateTimeOffset。 傳回值 Int32。 |
Minute( expression ) |
以介於 0 到 59 之間的 Int32 格式傳回 expression 的分鐘部分。 引數 DateTime, Time 或 DateTimeOffset。 傳回值 Int32。 範例
|
Month (expression) |
以介於 1 到 12 之間的 Int32 格式傳回 expression 的月份部分。 引數 DateTime 或 DateTimeOffset。 傳回值 Int32。 範例
|
Second( expression ) |
以介於 0 到 59 之間的 Int32 格式傳回 expression 的秒鐘部分。 引數 DateTime, Time 和 DateTimeOffset。 傳回值 Int32。 範例
|
TruncateTime( expression ) |
傳回 expression，含已截斷的時間值。 引數 DateTime 或 DateTimeOffset。 傳回值 expression 的型別。 |
Year( expression ) |
以 Int32 YYYY 格式傳回 expression 的年份部分。 引數 DateTime 和 DateTimeOffset。 傳回值 Int32。 範例
|
如果提供 null 輸入，這些函式會傳回 null。
Microsoft SQL Client Managed Provider 中提供了對等的功能。 如需詳細資訊，請參閱 適用於 Entity Framework 的 .NET Framework Data Provider for SQL Server (SqlClient) 函式。