日時データ・タイプの変更

ODBC ドライバーは、ODBC 2.0 と ODBC 3.0 の両方で、入力の日時値をサポートします。出力の場合、ODBC ドライバーは環境属性の設定値に基づいて、 戻す値を決定します。

ODBC 3.0 では、日付、時刻、およびタイム・スタンプが変更になりま した。表 1 (SQL タイプのマッピング) およ び 表 2 (C タイプのマッピング) で定義された値の ために、#define ディレクティブが組み込みファイル sqlcli1.h に 追加されました。
  • 入力の場合、ODBC 2.0 または ODBC 3.0 の日時値のいずれかを Db2® ODBC 3.0 ドライバーで使用できます。
  • 出力の場合、Db2 ODBC 3.0 ドライバーは SQL_ATTR_ODBC_VERSION 環境属性の設定値に基づいて、 戻すべき該当の値を決定します。
    • SQL_ATTR_ODBC_VERSION = SQL_OV_ODBC2 の場合、出力の日時値は ODBC 2.0 の値です。
    • SQL_ATTR_ODBC_VERSION = SQL_OV_ODBC3 の場合、出力の日時値は ODBC 3.0 の値です。

次の図は、SQL タイプと C タイプの ID をそれぞれ識別するために対応する ODBC 2.0 と ODBC 3.0 のマッピングが示してあります。

表 1. 日時データ・タイプのマッピング: SQL タイプ ID
ODBC 2.0 ODBC 3.0
SQL_DATE(9) SQL_TYPE_DATE(91)
SQL_TIME(10) SQL_TYPE_TIME(92)
SQL_TIMESTAMP(11) SQL_TYPE_TIMESTAMP(93)
表 2. 日時データ・タイプのマッピング: C タイプ ID
ODBC 2.0 ODBC 3.0
SQL_C_DATE(9) SQL_C_TYPE_DATE(91)
SQL_C_TIME(10) SQL_C_TYPE_TIME(92)
SQL_C_TIMESTAMP(11) SQL_C_TYPE_TIMESTAMP(93)
変更の始まりSQL_C_TIMESTAMP_EXT変更の終わり 変更の始まりSQL_C_TYPE_TIMESTAMP_EXT変更の終わり
日時データ・タイプの変更は、以下の関数に影響を与えます。
  • SQLBindCol()
  • SQLBindParameter()
  • SQLColAttribute()
  • SQLColumns()
  • SQLDescribeCol()
  • SQLDescribeParam()
  • SQLGetData()
  • SQLGetTypeInfo()
  • SQLProcedureColumns()
  • SQLStatistics()
  • SQLSpecialColumns()