日付と時刻関数
.NET Framework Data Provider for SQL Server (SqlClient) には、System.DateTime 型の入力値に対して操作を実行し、string、数値、または System.DateTime 値の結果を返す日付と時刻関数が用意されています。 これらの関数は、SqlClient の SqlServer 名前空間に存在します。 Entity Framework は、プロバイダーの名前空間プロパティを使用することにより、型や関数など、特定のコンストラクターに対してこのプロバイダーによってどのプレフィックスが使用されているかを特定できます。 次の表に、SqlClient の日付と時刻の関数を示します。
| 関数 | 説明 |
|---|---|
DATEADD(datepart, number, date) |
指定された日付に特定の期間を加えた新しい DateTime 型の値を返します。引数 datepart:新しい値を返す対象となる日付の要素を表す String。number:Int32 に加算する値 (Int64、Decimal、Double、datepart のいずれか)。date: 有効桁数が 0 から 7 の DateTime、DateTimeOffset、Time のいずれかの値を返す式、または日付形式の文字列。戻り値 有効桁数が 0 ～ 7 の DateTime、DateTimeOffset、または Time の新しい値。例 SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime)) |
DATEDIFF(datepart,startdate,enddate) |
指定された 2 つの日付間の差を、日付および時刻の単位で返します。 引数 datepart:差分を計算する日付の要素を表す String。startdate:計算の開始日として、有効桁数が 0 から 7 の DateTime、DateTimeOffset、Time のいずれかの値を返す式、または日付形式の文字列を指定します。enddate: 計算の終了日として、有効桁数が 0 から 7 の DateTime、DateTimeOffset、Time のいずれかの値を返す式、または日付形式の文字列を指定します。戻り値 Int32。例 SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),cast('6/20/2006' as DateTime)) |
DATENAME(datepart, date) |
指定された日付の特定の日付構成要素を文字列で返します。 引数 datepart:新しい値を返す対象となる日付の要素を表す String。date:有効桁数が 0 から 7 の DateTime,、DateTimeOffset、Time のいずれかの値を返す式、または日付形式の文字列。戻り値 指定された日付について、特定の日付要素を表す文字列。 例 SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
指定された日付について、特定の日付要素を整数で返します。 引数 datepart:新しい値を返す対象となる日付の要素を表す String。date:有効桁数が 0 から 7 の DateTime,、DateTimeOffset,、Time のいずれかの値を返す式、または日付形式の文字列。戻り値 指定された日付の特定の日付要素を表す Int32 値。例 SqlServer.DATEPART('year', cast('6/9/2006' as DateTime)) |
DAY(date) |
指定された日付の日を整数として返します。 引数 date有効桁数が 0 から 7 の DateTime 型または DateTimeOffset 型の式。戻り値 指定された日付の日を表す Int32 値。例 SqlServer.DAY(cast('6/9/2006' as DateTime)) |
GETDATE() |
datetime 値に使用する現在の日付と時刻を SQL Server の内部形式で生成します。 戻り値 有効桁数が 3 の DateTime としての現在のシステム日時。例 SqlServer.GETDATE() |
GETUTCDATE() |
UTC (協定世界時またはグリニッジ標準時) 形式の datetime 値を生成します。 戻り値 UTC 形式の有効桁数 3 の DateTime 値。例 SqlServer.GETUTCDATE() |
MONTH(date) |
指定された日付の月を整数として返します。 引数 date有効桁数が 0 から 7 の DateTime 型または DateTimeOffset 型の式。戻り値 指定された日付の月を表す Int32 値。例 SqlServer.MONTH(cast('6/9/2006' as DateTime)) |
YEAR(date) |
指定された日付の年を整数として返します。 引数 date有効桁数が 0 から 7 の DateTime 型または DateTimeOffset 型の式。戻り値 指定された日付の年を表す Int32 値。例 SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
有効桁数が 7 の DateTime 値を返します。戻り値 有効桁数が 7 の DateTime 値。例 SqlServer.SYSDATETIME() |
SYSUTCDATE() |
UTC (協定世界時またはグリニッジ標準時) 形式の datetime 値を生成します。 戻り値 UTC 形式の有効桁数 7 の DateTime 値。例 SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
有効桁数が 7 の DateTimeOffset 値を返します。戻り値 UTC 形式の有効桁数 7 の DateTimeOffset 値。例 SqlServer.SYSDATETIMEOFFSET() |
SqlClient でサポートされる日付と時刻の関数について詳しくは、「日付と時刻のデータ型および関数 (Transact-SQL)」をご覧ください。