[アーティクル]
09/28/2010

ODBC の日付/時刻の強化に対するデータ型のサポート

このトピックでは、SQL Server の日付と時刻のデータ型をサポートする ODBC 型について説明します。

パラメータと結果セットでのデータ型マッピング

SQL Server Native Client ODBC では、サーバーの新しい型を公開するために、ODBC データ型 (SQL_TYPE_TIMESTAMP と SQL_TIMESTAMP) に加え、次の新しい 2 つのデータ型が必要になります。

SQL_SS_TIME2
SQL_TIMESTAMPOFFSET

次の表に、完全なサーバーの型マッピングを示します。表の一部のセルには、2 つの項目が記載されています。このような場合、1 つ目は ODBC 3.0 の値、2 つ目は ODBC 2.0 の値です。

SQL Server データ型	SQL データ型	値
Datetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	93 (sql.h) 11 (sqlext.h)
Smalldatetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	93 (sql.h) 11 (sqlext.h)
Date	SQL_TYPE_DATE SQL_DATE	91 (sql.h) 9 (sqlext.h)
Time	SQL_SS_TIME2	-154 (SQLNCLI.h)
DatetimeOFFSET	SQL_SS_TIMESTAMPOFFSET	-155 (SQLNCLI.h)
Datetime2	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	93 (sql.h) 11 (sqlext.h)

次の表に、対応する構造体と ODBC C 型を示します。ODBC ではドライバで定義された C 型が許可されないため、time と datetimeoffset では、SQL_C_BINARY がバイナリ構造体として使用されます。

SQL データ型	メモリレイアウト	既定の C データ型	値 (sqlext.h)
SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	SQL_TIMESTAMP_STRUCT TIMESTAMP_STRUCT	SQL_C_TYPE_TIMESTAMP SQL_C_TIMESTAMP	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP
SQL_TYPE_DATE SQL_DATE	SQL_DATE_STRUCT DATE_STRUCT	SQL_C_TYPE_DATE SQL_C_DATE	SQL_TYPE_DATE SQL_DATE
SQL_SS_TIME2	SQL_SS_TIME2_STRUCT	SQL_C_BINARY	SQL_BINARY (-2)
SQL_SS_TIMESTAMPOFFSET	SQL_SS_TIMESTAMPOFFSET_STRUCT	SQL_C_BINARY	SQL_BINARY (-2)

SQL_C_BINARY バインドを指定すると、配置チェックが実行され、配置が正しくない場合はエラーが報告されます。このエラーの SQLSTATE は IM016 で、メッセージは "構造体の配置が正しくありません" です。

データ形式 : 文字列とリテラル

次の表に、SQL Server データ型、ODBC データ型、ODBC 文字列リテラルの間のマッピングを示します。

SQL Server データ型	ODBC データ型	クライアントで変換した場合の文字列の形式
Datetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	'yyyy-mm-dd hh:mm:ss[.999]' SQL Server では、datetime における秒の小数部の桁数を 3 桁までサポートします。
Smalldatetime	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	'yyyy-mm-dd hh:hh:ss' このデータ型の精度は 1 分です。秒の部分は、出力時には 0 になり、入力時にはサーバーによって丸められます。
Date	SQL_TYPE_DATE SQL_DATE	'yyyy-mm-dd'
Time	SQL_SS_TIME2	'hh:mm:ss[.9999999]' 秒の小数部には、必要に応じて最大 7 桁まで指定できます。
Datetime2	SQL_TYPE_TIMESTAMP SQL_TIMESTAMP	'yyyy-mm-dd hh:mm:ss[.9999999]' 秒の小数部には、必要に応じて最大 7 桁まで指定できます。
DatetimeOFFSET	SQL_SS_TIMESTAMPOFFSET	'yyyy-mm-dd hh:mm:ss[.9999999] +/- hh:mm' 秒の小数部には、必要に応じて最大 7 桁まで指定できます。

日付リテラルまたは時刻リテラルの ODBC エスケープシーケンスに変更はありません。

結果に含まれる秒の小数部には、常に、コロン (:) ではなくドット (.) を使用します。

アプリケーションに返される文字列値は、指定された列に対して常に同じ長さになります。年、月、日、時、分、秒の各部分は、最大幅に合わせて先頭にゼロが埋め込まれます。また、datetime 値の日付と時刻の間には空白が 1 つ入ります。datetimeoffset 値では、時間とタイムゾーンオフセットの間にも空白が 1 つ入ります。タイムゾーンオフセットの前には常に符号を指定します。オフセットが 0 の場合は、正符号 (+) を指定します。秒の小数部では、必要に応じて、列に定義されている有効桁数になるまで後ろにゼロが埋め込まれます。datetime 列の場合、秒の小数部は 3 桁になります。smalldatetime 列の場合、秒の小数部はなく、秒は常にゼロになります。

空の文字列は、有効な日付リテラルまたは時刻リテラルではありません。また、NULL 値を表すものでもありません。空の文字列を日付または時刻の値に変換しようとすると、SQLState 22018 のエラーが発生し、"キャストした文字コードが正しくありません" というメッセージが表示されます。

文字列パラメータからの変換では、文字列が同じ形式である必要があります。ただし、0 時 0 分のタイムゾーンの符号が正符号と負符号のどちらも指定できる点と、秒の小数部では最大 9 桁になるように末尾にゼロを含めることができる点は同じである必要はありません。時刻部分は、小数点で終了して、秒の小数部を省略することができます。

現在は、句読点の前後に空白を追加することができ、時間とタイムゾーンオフセットの間の空白は省略可能です。ただし、これは将来のリリースで変更される可能性があるので、アプリケーションは現在の動作に依存しないようにしてください。

データ形式 : データ構造体

後述の構造体では、ODBC によって次の制約が定められています。これらはグレゴリオ暦を取り入れたものです。

月の範囲は 1 ～ 12 です。
日フィールドの範囲は 1 からその月の日数までです。この範囲は、うるう年を考慮して、年フィールドおよび月フィールドと一貫性を保つ必要があります。
時刻の範囲は 0 ～ 23 です。
分の範囲は 0 ～ 59 です。
秒の範囲は 0 ～ 61.9(n) です。この範囲では、恒星時との同期を維持するために最大 2 秒のうるう秒が許可されています。

SQL Server はうるう秒を許可しないので、秒の値が 59 を超えるとサーバーエラーが発生することに注意してください。

次の既存の ODBC 構造体の実装は、SQL Server の新しい日付と時刻のデータ型をサポートするように変更されました。ただし、定義は変更されていません。

DATE_STRUCT
TIME_STRUCT
TIMESTAMP_STRUCT

また、次の新しい 2 つの構造体が導入されました。

SQL_SS_TIME2_STRUCT
SQL_SS_TIMESTAMPOFFSET_STRUCT

SQL_SS_TIME2_STRUCT

これは SQL Server 2008 の新しい構造体です。32 ビットと 64 ビットの両方のオペレーティングシステムで、12 バイトまで埋め込みが行われます。

typedef struct tagSS_TIME2_STRUCT {
   SQLUSMALLINT hour;
   SQLUSMALLINT minute;
   SQLUSMALLINT second;
   SQLUINTEGER fraction;
} SQL_SS_TIME2_STRUCT;

SQL_SS_TIMESTAMPOFFSET_STRUCT

これは SQL Server 2008 の新しい構造体です。

typedef struct tagSS_TIMESTAMPOFFSET_STRUCT {
   SQLSMALLINT year;
   SQLUSMALLINT month;
   SQLUSMALLINT day;
   SQLUSMALLINT hour;
   SQLUSMALLINT minute;
   SQLUSMALLINT second;
   SQLUINTEGER fraction;
   SQLSMALLINT timezone_hour;
   SQLSMALLINT timezone_minute;
} SQL_SS_TIMESTAMPOFFSET_STRUCT;

timezone_hour が負の値の場合、timezone_minute は負の値または 0 である必要があります。timezone_hour が正の値の場合、timezone_minute は正の値または 0 である必要があります。timezone_hour が 0 の場合、timezone_minute には、-59 ～ +59 の範囲内の任意の値を指定できます。

次の方法で共有