日付と時刻の正規関数

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) 世界協定時刻 (UTC) を基準としたサーバーの現在の日時として新しい DateTimeOffset 値を返します。

引数

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() UTC タイム ゾーンでのサーバーの現在の日時として DateTime 値を返します。

戻り値

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 の日付の部分を 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) GMTからのdatetimeoffsetのずれを分単位で返します。 この値は通常、+780 ~ -780 (+ 13 時間~ - 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) expression の分の部分を 0 ~ 59 の間の 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 Int32 として YYYY の年の部分を返します。

引数

DateTime および DateTimeOffset。

戻り値

Int32。

例

-- The following example returns 1998.

Year(cast('03/12/1998' as DateTime))

null が入力された場合、これらの関数は null を返します。

同等の機能は、Microsoft SQL クライアント マネージド プロバイダーでも利用できます。 詳細については、「Entity Framework 用 SqlClient 関数」を参照してください。

関連項目