从 C 到 SQL:日期时间间隔
日时间间隔 ODBC C 数据类型的标识符为:
SQL_C_INTERVAL_DAY
SQL_C_INTERVAL_HOUR
SQL_C_INTERVAL_MINUTE
SQL_C_INTERVAL_SECOND
SQL_C_INTERVAL_DAY_TO_HOUR
SQL_C_INTERVAL_DAY_TO_MINUTE
SQL_C_INTERVAL_DAY_TO_SECOND
SQL_C_INTERVAL_HOUR_TO_MINUTE
SQL_C_INTERVAL_HOUR_TO_SECOND
SQL_C_INTERVAL_MINUTE_TO_SECOND
下表显示了可将间隔 C 数据转换为的 ODBC SQL 数据类型。 有关表中列和术语的说明,请参阅 将数据从 C 转换为 SQL 数据类型。
SQL 类型标识符 | 测试 | SQLSTATE |
---|---|---|
SQL_CHAR[a] SQL_VARCHAR[a] SQL_LONGVARCHAR[a] |
列字节长度 >= 字符字节长度 列字节长度 < 字符字节长度[a] 数据值不是有效的间隔文本 |
不适用 22001 22015 |
SQL_WCHAR[a] SQL_WVARCHAR[a] SQL_WLONGVARCHAR[a] |
列字符长度 >= 数据的字符长度 列字符长度 < 数据的字符长度[a] 数据值不是有效的间隔文本 |
不适用 22001 22015 |
SQL_TINYINT[b] SQL_SMALLINT[b] SQL_INTEGER[b] SQL_BIGINT[b] SQL_NUMERIC[b] SQL_DECIMAL[b] |
单字段间隔的转换不会导致截断整个数字 转换导致截断整个数字 |
不适用 22003 |
SQL_INTERVAL_DAY SQL_INTERVAL_HOUR SQL_INTERVAL_MINUTE SQL_INTERVAL_SECOND SQL_INTERVAL_DAY_TO_HOUR SQL_INTERVAL_DAY_TO_MINUTE SQL_INTERVAL_DAY_TO_SECOND SQL_INTERVAL_HOUR_TO_MINUTE SQL_INTERVAL_HOUR_TO_SECOND SQL_INTERVAL_MINUTE_TO_SECOND |
转换数据值时未截断任何字段 转换期间截断了一个或多个数据值的字段 |
不适用 22015 |
[a] 所有 C 间隔数据类型都可以转换为字符数据类型。
[b] 如果间隔结构中的类型字段是单个字段 (SQL_DAY、SQL_HOUR、SQL_MINUTE或SQL_SECOND) ,则可以将间隔 C 类型转换为任何确切的数值 (SQL_TINYINT、SQL_SMALLINT、SQL_INTEGER、SQL_BIGINT、SQL_DECIMAL或SQL_NUMERIC) 。
间隔 C 类型的默认转换为相应的日时间间隔 SQL 类型。
驱动程序在从间隔 C 数据类型转换数据时忽略长度/指示器值,并假定数据缓冲区的大小是间隔 C 数据类型的大小。 长度/指示器值在 SQLPutData 中的 StrLen_or_Ind 参数中传递,并使用 SQLBindParameter 中的 StrLen_or_IndPtr 参数指定的缓冲区中传递。 数据缓冲区是使用 SQLPutData 中的 DataPtr 参数和 SQLBindParameter 中的 ParameterValuePtr 参数指定的。
以下示例演示如何将存储在 SQL_INTERVAL_STRUCT 结构中的间隔 C 数据发送到数据库列。 间隔结构包含DAY_TO_SECOND间隔;它将存储在 SQL_INTERVAL_DAY_TO_MINUTE 类型的数据库列中。
SQL_INTERVAL_STRUCT is;
SQLINTEGER cbValue;
// Initialize the interval struct to contain the DAY_TO_SECOND
// interval "154 days, 22 hours, 44 minutes, and 10 seconds"
is.intval.day_second.day = 154;
is.intval.day_second.hour = 22;
is.intval.day_second.minute = 44;
is.intval.day_second.second = 10;
is.interval_sign = SQL_FALSE;
// Bind the dynamic parameter
SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_INTERVAL_DAY_TO_SECOND,
SQL_INTERVAL_DAY_TO_MINUTE, 0, 0, &is,
sizeof(SQL_INTERVAL_STRUCT), &cbValue);
// Execute an insert statement; "interval_column" is a column
// whose data type is SQL_INTERVAL_DAY_TO_MINUTE.
SQLExecDirect(hstmt,"INSERT INTO table(interval_column) VALUES (?)",SQL_NTS);