日期及時間標準函式
Entity SQL 包含日期與時間的標準函式。
備註
下表顯示 Entity SQL 中，日期與時間的標準函式。 datetime 是 DateTime 值。
| 函式 | 描述 |
|---|---|
AddNanoseconds(expression,number) |
將奈秒數的指定 number 加入至 expression。引數 expression：DateTime、DateTimeOffset 或 Time。傳回值 expression 的類型。 |
AddMicroseconds(expression,number) |
將毫秒數的指定 number 加入至 expression。引數 expression：DateTime、DateTimeOffset 或 Time。傳回值 expression 的類型。 |
AddMilliseconds(expression,number) |
將毫秒數的指定 number 加入至 expression。引數 expression：DateTime、DateTimeOffset 或 Time。傳回值 expression 的類型。 |
AddSeconds(expression,number) |
將秒數的指定 number 加入至 expression。引數 expression：DateTime、DateTimeOffset 或 Time。傳回值 expression 的類型。 |
AddMinutes(expression,number) |
將分鐘數的指定 number 加入至 expression。引數 expression：DateTime、DateTimeOffset 或 Time。傳回值 expression 的類型。 |
AddHours(expression,number) |
將時數的指定 number 加入至 expression。引數 expression：DateTime、DateTimeOffset 或 Time。傳回值 expression 的類型。 |
AddDays(expression,number) |
將天數的指定 number 加入至 expression。引數 expression：DateTime 或 DateTimeOffset。傳回值 expression 的類型。 |
AddMonths(expression,number) |
將月份數的指定 number 加入至 expression。引數 expression：DateTime 或 DateTimeOffset。傳回值 expression 的類型。 |
AddYears(expression,number) |
將年數的指定 number 加入至 expression。引數 expression：DateTime 或 DateTimeOffset。傳回值 expression 的類型。 |
CreateDateTime(year,month,day,hour,minute,second) |
傳回新 DateTime 值作為此伺服器時區內之伺服器目前的日期和時間。引數 year、month、day、hour、minute：Int16 和 Int32。傳回值 DateTime。 |
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) |
傳回新 DateTimeOffset 值作為與國際標準時間 (UTC) 相關之伺服器目前的日期和時間。引數 傳回值 DateTimeOffset。 |
CreateTime(hour,minute,second) |
傳回新 Time 值做為目前時間。引數 hour 和 minute：Int32傳回值 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 35Minute(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 5Second(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。