日付データの SQL から C への変換

日付 SQL データ・タイプ SQL_TYPE_DATE を C データ・タイプに変換できます。

次の表は、日付 SQL データから C データへの変換 に関する情報を示しています。

表 1. 日付 SQL データから C データへの変換
fCType テスト rgbValue pcbValue SQLSTATE
SQL_C_CHAR cbValueMax >= 11 データ 10 000001
cbValueMax < 11 影響なし 10 22003
SQL_C_WCHAR cbValueMax >= 22 データ 20 000001
cbValueMax < 22 影響なし 20 22003
SQL_C_TYPE_DATE なし2 データ 64 000001
SQL_C_TYPE_TIMESTAMP なし2 Data3 164 000001
変更の始まりSQL_C_TYPE_TIMESTAMP_EXT 変更の終わり 変更の始まりなし2変更の終わり 変更の始まりデータ5変更の終わり 変更の始まり204変更の終わり 変更の始まり000001変更の終わり
SQL_C_BINARY データ長 <= cbValueMax データ データ長 (バイト) 000001
データ長 > cbValueMax 影響なし 影響なし 22003
注:
  1. SQLSTATE 00000 は、SQLGetDiagRec() によって 戻されるのではなく、関数が SQL_SUCCESS を戻すときに示されます。
  2. cbValueMax の値はこの変換では無視されます。 ドライバーは、rgbValue のサイズは C データ・タイプのサイズであると想定します。
  3. TIMESTAMP_STRUCT 構造の時刻フィールドはゼロに設定されます。
  4. これは、対応する C データ・タイプのサイズです。
  5. TIMESTAMP_STRUCT_EXT 構造の時刻フィールドはゼロに設定されます。

日付 SQL データ・タイプが文字 C データ・タイプに変換されると、 結果のストリングは、"yyyy-mm-dd" 形式になります。