クライアントからサーバーへの変換
このトピックでは、SQL Server Native Client OLE DB を使用して作成されたクライアント アプリケーションと SQL Server 2008 (以降) との間で実行される日付または時刻の変換について説明します。
変換
このトピックでは、クライアントで行われる変換について説明します。パラメーターに対して、サーバーで定義されているのとは異なる、秒の小数部の有効桁数をクライアントで指定した場合、サーバー側で変換すると処理に成功するのに、クライアント側で変換すると処理に失敗することがあります。具体的には、クライアントでは、秒の小数部の切り捨てがエラーとして処理されますが、SQL Server では時刻値が最も近い秒単位の値に丸められます。
ICommandWithParameters::SetParameterInfo が呼び出されない場合、DBTYPE_DBTIMESTAMP バインドは datetime2 の場合と同様に変換されます。
変換先 -> 変換元 |
DBDATE (date) |
DBTIME (time) |
DBTIME2 (time) |
DBTIMESTAMP (smalldatetime) |
DBTIMESTAMP (datetime) |
DBTIMESTAMP (datetime2) |
DBTIMESTAMPOFFSET (datetimeoffset) |
STR |
WSTR |
SQLVARIANT (sql_variant) |
|---|---|---|---|---|---|---|---|---|---|---|
DATE |
1,2 |
1,3,4 |
4,12 |
1,12 |
1,12 |
1,12 |
1,5, 12 |
1,12 |
1,12 |
1,12 datetime2(0) |
DBDATE |
1 |
- |
- |
1,6 |
1,6 |
1,6 |
1,5, 6 |
1,10 |
1,10 |
1 date |
DBTIME |
- |
1 |
1 |
1,7 |
1,7 |
1,7 |
1,5, 7 |
1,10 |
1,10 |
1 Time(0) |
DBTIME2 |
- |
1,3 |
1 |
1,7,10,14 |
1,7,10,15 |
1,7,10 |
1,5,7,10 |
1,10,11 |
1,10,11 |
1 Time(7) |
DBTIMESTAMP |
1,2 |
1,3,4 |
1,4,10 |
1,10,14 |
1,10,15 |
1,10 |
1,5,10 |
1,10,11 |
1,10,11 |
1,10 datetime2(7) |
DBTIMESTAMPOFFSET |
1,2,8 |
1,3,4,8 |
1,4,8,10 |
1,8,10,14 |
1,8,10,15 |
1,8,10 |
1,10 |
1,10,11 |
1,10,11 |
1,10 datetimeoffset(7) |
FILETIME |
1,2 |
1,3,4 |
1,4,13 |
1,13 |
1,13 |
1,13 |
1,5,13 |
1,13 |
1,10 |
1,13 datetime2(3) |
BYTES |
- |
- |
- |
- |
- |
- |
- |
なし |
なし |
なし |
VARIANT |
1 |
1 |
1 |
1,10 |
1,10 |
1,10 |
1,10 |
なし |
なし |
1,10 |
SSVARIANT |
1,16 |
1,16 |
1,16 |
1,10,16 |
1,10,16 |
1,10,16 |
1,10,16 |
なし |
なし |
1,16 |
BSTR |
1,9 |
1,9 |
1,9,10 |
1,9,10 |
1,9,10 |
1,9,10 |
1,9,10 |
なし |
なし |
なし |
STR |
1,9 |
1,9 |
1,9,10 |
1,9,10 |
1,9,10 |
1,9,10 |
1,9,10 |
なし |
なし |
なし |
WSTR |
1,9 |
1,9 |
1,9,10 |
1,9,10 |
1,9,10 |
1,9,10 |
1,9,10 |
なし |
なし |
なし |
記号の説明
記号 |
意味 |
|---|---|
- |
変換はサポートされていません。IAccessor::CreateAccessor の呼び出し時にバインドが検証される場合、DBBINDSTATUS_UPSUPPORTEDCONVERSION が rgStatus で返されます。アクセサー検証が遅延する場合は、DBSTATUS_E_BADACCESSOR が設定されます。 |
なし |
適用なし。 |
1 |
指定されたデータが有効でない場合、DBSTATUS_E_CANTCONVERTVALUE が設定されます。入力データが検証されてから変換が適用されるので、コンポーネントは後続の変換で無視されることがあっても、変換を成功させるには有効である必要があります。 |
2 |
時刻フィールドは無視されます。 |
3 |
秒の小数部は 0 である必要があります。そうでなければ、DBSTATUS_E_DATAOVERFLOW が設定されます。 |
4 |
日付部分は無視されます。 |
5 |
タイム ゾーンには、クライアントのタイム ゾーン設定が設定されます。 |
6 |
時刻は 0 に設定されます。 |
7 |
日付は現在の日付に設定されます。 |
8 |
時刻は UTC に変換されます。この変換中にエラーが発生した場合、DBSTATUS_E_CANTCONVERTVALUE が設定されます。 |
9 |
文字列は ISO リテラルとして解析され、対象の型に変換されます。これが失敗すると、文字列は OLE 日付リテラル (時刻要素も含む) として解析され、OLE Date (DBTYPE_DATE) から対象の型に変換されます。 対象の型が DBTIMESTAMP、smalldatetime、datetime、または datetime2 の場合、文字列は日付リテラル、時刻リテラル、または datetime2 リテラルの構文か、OLE で認識される構文に準拠している必要があります。文字列が日付リテラルの場合、すべての時刻部分が 0 に設定されます。文字列が時刻リテラルの場合、日付は現在の日付に設定されます。 その他の対象の型の場合、文字列は対象の型のリテラルの構文に準拠している必要があります。 |
10 |
データ損失を伴って秒の小数部が切り捨てられる場合、DBSTATUS_E_DATAOVERFLOW が設定されます。文字列変換では、文字列が ISO 構文に準拠している場合のみオーバーフロー チェックが有効になります。文字列が OLE 日付リテラルの場合、秒の小数部は丸められます。 DBTIMESTAMP (datetime) から smalldatetime への変換では、SQL Server Native Client によって秒の値が暗黙に切り捨てられ、DBSTATUS_E_DATAOVERFLOW エラーは生成されません。 |
11 |
秒の小数点以下桁数は、次の表に従って、変換先の列のサイズによって決まります。テーブルの範囲よりサイズが大きい列の場合は、9 桁と見なされます。この変換では、秒の小数点以下桁数が 9 桁まで許容されます。これは、OLE DB で許容される最大桁数です。 ただし、変換元の型が DBTIMESTAMP で、秒の小数部が 0 の場合、秒の小数部または小数点は生成されません。この動作により、以前の OLE DB プロバイダーを使用して開発されたアプリケーションの下位互換性が保証されます。 列サイズが 0 未満の場合は、OLE DB ではサイズが無制限であることを意味します (DBTIMESTAMP の 3 桁ルールが適用されなければ 9 桁)。
データ型長さ (文字数)小数点以下桁数
DBTIME28, 10..180,1..9
DBTIMESTAMP19, 21..290,1..9
DBTIMESTAMPOFFSET26, 28..360,1..9
|
12 |
SQL Server 2008 より前のバージョンの DBTYPE_DATE に対する変換セマンティクスが保持されます。秒の小数部は 0 に切り捨てられます。 |
13 |
SQL Server 2008 より前のバージョンの DBTYPE_FILETIME に対する変換セマンティクスが保持されます。Windows FileTimeToSystemTime API を使用する場合、1 秒未満の秒の有効桁数は 1 ミリ秒に制限されます。 |
14 |
SQL Server 2008 より前のバージョンの smalldatetime に対する変換セマンティクスが保持されます。秒は 0 に設定されます。 |
15 |
SQL Server 2008 より前のバージョンの datetime に対する変換セマンティクスが保持されます。秒は、1/300 秒単位に丸められます。 |
16 |
SSVARIANT クライアントの構造体に埋め込まれた (特定の型の) 値の変換動作は、SSVARIANT クライアントの構造体に埋め込まれていない場合の同一の値および型の動作と同じです。 |