日付と時刻のデータ

SQL Server 2008 では、日付と時刻の情報を扱うための新しいデータ型が導入されました。 新しいデータ型には、日付と時刻の別個のデータ型と、範囲、有効桁数、タイム ゾーン処理が向上した拡張データ型が含まれています。 .NET Framework 3.5 Service Pack (SP) 1 以降では、.NET Framework Data Provider for SQL Server (System.Data.SqlClient) が SQL Server 2008 データベース エンジンの新機能すべてをサポートします。 SqlClient でこれらの新機能を使用するには、.NET Framework 3.5 SP1 以降をインストールする必要があります。

SQL Server 2008 より前のバージョンの SQL Server では、日付と時刻に使用できるデータ型には datetime と smalldatetime の 2 つしかありませんでした。 どちらのデータ型も日付値と時刻値の両方を保持するため、日付と時刻のどちらか一方の値のみを使用するのが困難でした。 さらに、これらのデータ型では、1753 年に英国でグレゴリオ暦が導入された後の日付のみがサポートされます。 もう 1 つの制限事項は、これらの古いデータ型がタイムゾーンに対応していないことです。これにより、複数のタイムゾーンからのデータの操作が困難になります。

SQL Server の日付と時刻の型の詳細については、「日付と時刻のデータ型および関数」を参照してください。

SQL Server 2008 で導入された日付/時刻データ型

次の表は、新しい日付と時刻のデータ型の説明です。

日付書式と表記順序

SQL Server が日付と時刻の値をどのように処理するかは、型システムのバージョンとサーバーのバージョンだけでなく、サーバーの既定の言語と書式設定にも左右されます。 ある言語の日付形式に対して機能する日付文字列は、別の言語および日付形式の設定を使用する接続によってクエリが実行された場合に認識されない可能性があります。

Transact-SQL SET LANGUAGE ステートメントでは、日付部分の順序を決定する DATEFORMAT を暗黙的に設定します。 接続に対して SET DATEFORMAT Transact-SQL ステートメントを使用して、MDY、DMY、YMD、YDM、MYD、DYM の順序で日付部分を並べ替えることにより、日付値を明確にすることができます。

接続に対して DATEFORMAT を指定しない場合、SQL Server では接続に関連付けられている既定の言語が使用されます。 たとえば、' 01/02/03' の日付文字列は、米国英語の言語設定のサーバーでは MDY (2003 年 1 月 2 日) として解釈され、英国英語の言語設定のサーバーでは DMY (2003 年 2 月 1 日) として解釈されます。 年は、SQL Server の終了年の規則に従って決定されます。この規則では、世紀の値を割り当てるための終了日が定義されます。 詳しくは、「two digit year cutoff オプション」をご覧ください。

SQL Server による日付と時刻のデータの解釈方法について詳しくは、「日時データの使用」をご覧ください。

Date/Time データ型とパラメーター

新しい日付型と時刻型をサポートするために、SqlDbType には、次の列挙値が追加されています。

• SqlDbType.Date

• SqlDbType.Time

• SqlDbType.DateTime2

• SqlDbType.DateTimeOffSet

SqlParameter のデータ型は、前の SqlDbType 列挙型のいずれかの値を使って指定できます。

SqlParameter オブジェクトの DbType プロパティを特定の SqlParameter 列挙値に設定することによって、DbType の型をジェネリックに指定することもできます。 DbType データ型と datetime2 データ型をサポートするために、datetimeoffset には、次の列挙値が追加されています。

• DbType.DateTime2

• DbType.DateTimeOffset

これらの新しい列挙値は、以前のバージョンの .NET Framework に存在した Date、Time、および DateTime の各列挙値を補います。

パラメーター オブジェクトの .NET Framework データ プロバイダー型は、パラメーター オブジェクトの値の .NET Framework 型か、またはパラメーター オブジェクトの DbType から推論されます。 新しい date 型と time 型をサポートするための新しい System.Data.SqlTypes データ型は導入されていません。 次の表に、SQL Server 2008 の日付と時刻のデータ型と CLR データ型のマッピングについて説明します。

SqlParameter プロパティ

次の表は、日付と時刻のデータ型に関係する SqlParameter プロパティの説明です。

パラメーターの作成

SqlParameter オブジェクトは、そのコンストラクターを使って作成できるほか、SqlCommand の Parameters メソッドを呼び出して、AddSqlParameterCollection コレクションにそれを追加することによって作成することもできます。 Add メソッドは、入力としてコンストラクター引数または既存のパラメーター オブジェクトを受け取ります。

このトピックの次のセクションでは、日付と時刻のパラメーターを指定する方法の例を示します。 パラメーターの使用に関するその他の例については、「パラメーターおよびパラメーター データ型の構成」および「DataAdapter パラメーター」をご覧ください。

Date の例

次のコード フラグメントは、date パラメーターの指定方法を示しています。

SqlParameter parameter = new SqlParameter();  
parameter.ParameterName = "@Date";  
parameter.SqlDbType = SqlDbType.Date;  
parameter.Value = "2007/12/1";  

Dim parameter As New SqlParameter()  
parameter.ParameterName = "@Date"  
parameter.SqlDbType = SqlDbType.Date  
parameter.Value = "2007/12/1"  

Time の例

次のコード フラグメントは、time パラメーターの指定方法を示しています。

SqlParameter parameter = new SqlParameter();  
parameter.ParameterName = "@time";  
parameter.SqlDbType = SqlDbType.Time;  
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;  

Dim parameter As New SqlParameter()  
parameter.ParameterName = "@Time"  
parameter.SqlDbType = SqlDbType.Time  
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;  

Datetime2 の例

次のコード フラグメントは、datetime2 パラメーターの日付と時刻の指定方法を示しています。

SqlParameter parameter = new SqlParameter();  
parameter.ParameterName = "@Datetime2";  
parameter.SqlDbType = SqlDbType.DateTime2;  
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");  

Dim parameter As New SqlParameter()  
parameter.ParameterName = "@Datetime2"  
parameter.SqlDbType = SqlDbType.DateTime2  
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");  

DateTimeOffSet の例

次のコード フラグメントは、DateTimeOffSet パラメーターの日付と時刻、およびタイム ゾーン オフセット 0 を指定する方法を示しています。

SqlParameter parameter = new SqlParameter();  
parameter.ParameterName = "@DateTimeOffSet";  
parameter.SqlDbType = SqlDbType.DateTimeOffSet;  
parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");  

Dim parameter As New SqlParameter()  
parameter.ParameterName = "@DateTimeOffSet"  
parameter.SqlDbType = SqlDbType.DateTimeOffSet  
parameter.Value = DateTimeOffset.Parse("1666-09-02 1:00:00+0");  

AddWithValue

次のコード フラグメントに示すように、SqlCommand の AddWithValue メソッドを使用してパラメーターを指定することもできます。 ただし、AddWithValue メソッドでは、パラメーターの DbType または SqlDbType を指定することはできません。

command.Parameters.AddWithValue(
    "@date", DateTimeOffset.Parse("16660902"));  

command.Parameters.AddWithValue( _  
    "@date", DateTimeOffset.Parse("16660902"))  

@date パラメーターは、サーバー上の date、datetime、または datetime2 データ型にマッピングできます。 新しい datetime データ型を使用する場合は、パラメーターの SqlDbType プロパティをインスタンスのデータ型に明示的に設定する必要があります。 Variant を使用するか、または暗黙的にパラメーター値を指定すると、datetime データ型および smalldatetime データ型との下位互換性の問題が発生する可能性があります。

次の表は、どの CLR 型からどの SqlDbTypes が推論されるかを示しています。

日付と時刻データの取得

SQL Server 2008 の日付値および時刻値を取得するためのメソッドを次の表に示します。

日付値と時刻値のリテラル指定

日付と時刻のデータ型は、さまざまなリテラル文字列形式を使用して指定できます。SQL Server は、実行時にそれらを内部の日付/時刻構造体に変換します。 SQL Server では、一重引用符 (') で囲まれた日付と時刻のデータが認識されます。 次の例に、いくつかの形式を示します。

• アルファベットの日付形式 ('October 15, 2006' など)。

• 数値の日付形式 ('10/15/2006'など)。

• 区切られていない文字列形式 ('20061015' など。これは ISO 標準日付形式を使用している場合、2006 年 10 月 15 日と解釈される)。

時刻の値が 0 と 24 の間にない場合は、ArgumentException がスローされます。

SQL Server ドキュメントのリソース

SQL Server での日付と時刻の値の使用方法の詳細については、以下の記事を参照してください。

関連項目

• SQL Server データ型のマッピング
• パラメーターおよびパラメーター データ型の構成
• SQL Server データ型と ADO.NET
• ADO.NET の概要