日期及時間標準函式

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、、monthday、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) 傳回 expression 的天數部分,以 Int32 表示,範圍介於 1 到 366,其中 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) 傳回 expression 的年份部分,作為 Int32YYYY。

引數

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。

另請參閱