タイム・スタンプ・データの SQL から C への変換

タイム・スタンプ SQL データ・タイプ SQL_TYPE_TIMESTAMP を C データ・タイプに変換できます。

次の表は、タイム・スタンプ SQL データから C データへの変換に関する情報を示しています。

表 1. タイム・スタンプ SQL データから C データへの変換
fCType テスト rgbValue pcbValue SQLSTATE
SQL_C_CHAR 表示サイズ < cbValueMax データ データ長 (バイト) 000001
19 <= cbValueMax <= 表示サイズ 切り捨てられたデータ 2 データ長 (バイト) 01004
cbValueMax < 19 影響なし データ長 (バイト) 22003
SQL_C_WCHAR 表示サイズ < cbValueMax データ データ長 (バイト) 000001
38 <= cbValueMax <= 表示サイズ 切り捨てられたデータ 2 データ長 (バイト) 01004
cbValueMax < 38 影響なし データ長 (バイト) 22003
SQL_C_TYPE_DATE なし 切り捨てられたデータ3 64 01004
SQL_C_TYPE_TIME なし5 切り捨てられたデータ6 64 01004
SQL_C_TYPE_TIMESTAMP なし5 データ 164 000001
タイム・スタンプの小数点以下の 秒の部分が切り捨てられる。 5 データ2 16 01004
変更の始まりSQL_C_TYPE_TIMESTAMP_EXT 変更の終わり 変更の始まりなし5変更の終わり 変更の始まりデータ変更の終わり 変更の始まり 20変更の終わり 変更の始まり00000変更の終わり
注:
  1. SQLSTATE 00000 は、SQLGetDiagRec() によって 戻されるのではなく、関数が SQL_SUCCESS を戻すときに示されます。
  2. タイム・スタンプの小数点以下の秒が切り捨てられます。
  3. タイム・スタンプの時刻部分が削除されます。
  4. これは、対応する C データ・タイプのサイズです。
  5. cbValueMax の値はこの変換では無視されます。 ドライバーは、rgbValue のサイズは C データ・タイプのサイズであると想定します。
  6. タイム・スタンプの日付部分が削除されます。

タイム・スタンプ SQL データ・タイプが文字 C データ・タイプに変換される際、結果ストリングは「yyyy-mm-dd hh:mm:ss[.fff[fff]]」形式になります (タイム・スタンプ SQL データ・タイプの精度に関係なく)。