C zu SQL: Tag-Uhrzeit-Intervalle
Die Bezeichner für die ODBC C-Datentypen des Tag-Zeitintervalls sind:
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
Die folgende Tabelle zeigt die ODBC SQL-Datentypen, in die C-Intervalldaten konvertiert werden können. Eine Erläuterung der Spalten und Begriffe in der Tabelle finden Sie unter Konvertieren von Daten aus C in SQL-Datentypen.
| SQL-Typbezeichner | Test | SQLSTATE |
|---|---|---|
| SQL_CHAR[a] SQL_VARCHAR[a] SQL_LONGVARCHAR[a] |
Spaltenbytelänge >= Zeichenbytelänge Spaltenbytelänge < Zeichenbytelänge[a] Der Datenwert ist kein gültiges Intervallliteral. |
– 22001 22015 |
| SQL_WCHAR[a] SQL_WVARCHAR[a] SQL_WLONGVARCHAR[a] |
Spaltenzeichenlänge >= Zeichenlänge der Daten Spaltenzeichenlänge < Zeichenlänge von data[a] Der Datenwert ist kein gültiges Intervallliteral. |
– 22001 22015 |
| SQL_TINYINT[b] SQL_SMALLINT[b] SQL_INTEGER[b] SQL_BIGINT[b] SQL_NUMERIC[b] SQL_DECIMAL[b] |
Die Konvertierung eines einfeldigen Intervalls hat keine Kürzung ganzer Ziffern zur Folge. Konvertierung führte zum Abschneiden ganzer Ziffern |
– 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 |
Der Datenwert wurde ohne Abschneiden von Feldern konvertiert. Mindestens ein Feld des Datenwerts wurde während der Konvertierung abgeschnitten. |
– 22015 |
[a] Alle C-Intervalldatentypen können in einen Zeichendatentyp konvertiert werden.
[b] Wenn das Typfeld in der Intervallstruktur so ist, dass das Intervall ein einzelnes Feld (SQL_DAY, SQL_HOUR, SQL_MINUTE oder SQL_SECOND) ist, kann der Intervall-C-Typ in einen beliebigen exakten numerischen Typ (SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT, SQL_DECIMAL oder SQL_NUMERIC) konvertiert werden.
Die Standardkonvertierung eines Intervall-C-Typs ist in den entsprechenden SQL-Typ für das Tages-Zeit-Intervall.
Der Treiber ignoriert den Längen-/Indikatorwert beim Konvertieren von Daten aus dem Intervall-C-Datentyp und geht davon aus, dass die Größe des Datenpuffers der Größe des Intervall-C-Datentyps entspricht. Der Längen-/Indikatorwert wird im argument StrLen_or_Ind in SQLPutData und im Puffer übergeben, der mit dem argument StrLen_or_IndPtr in SQLBindParameter angegeben ist. Der Datenpuffer wird mit dem Argument DataPtr in SQLPutData und dem Argument ParameterValuePtr in SQLBindParameter angegeben.
Im folgenden Beispiel wird veranschaulicht, wie in der SQL_INTERVAL_STRUCT-Struktur gespeicherte C-Intervalldaten an eine Datenbankspalte gesendet werden. Die Intervallstruktur enthält ein DAY_TO_SECOND Intervall. Sie wird in einer Datenbankspalte vom Typ SQL_INTERVAL_DAY_TO_MINUTE gespeichert.
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);