Литералы даты, времени и отметок времени
Escape-последовательность для литерала даты, времени и метки времени
{ -type ' value '}
где литерал является одним из значений, перечисленных в следующей таблице.
| литеральный тип | Значение | Формат значения |
|---|---|---|
| дн. | Дата | гггг-мм-дд |
| с | Время* | hh:mm:ss[1] |
| ts | Метка времени | гггг мм--дд чч:мм:ss[.f...][1] |
[1] Число цифр справа от десятичной запятой в литерал интервала времени или метки времени, содержащего компонент секунд, зависит от точности секунд, как указано в поле дескриптора SQL_DESC_PRECISION. (Дополнительные сведения см. в разделе SQLSetDescField.)
Дополнительные сведения о последовательностях escape-меток даты, времени и метки времени см. в разделе "Даты,время" и "Метка времени" в приложении C: грамматика SQL.
Например, оба из следующих инструкций SQL обновляют открытую дату заказа на продажу 1023 в таблице "Заказы". Первая инструкция использует синтаксис escape-последовательности. Вторая инструкция использует собственный синтаксис Oracle Rdb для столбца DATE и не совместим.
UPDATE Orders SET OpenDate={d '1995-01-15'} WHERE OrderID=1023
UPDATE Orders SET OpenDate='15-Jan-1995' WHERE OrderID=1023
Escape-последовательность для литерала даты, времени или метки времени также может быть помещена в символьную переменную, привязанную к параметру даты, времени или метки времени. Например, следующий код использует параметр даты, привязанный к символьной переменной, для обновления открытой даты заказа на продажу 1023 в таблице Orders:
SQLCHAR OpenDate[56]; // The size of a date literal is 55.
SQLINTEGER OpenDateLenOrInd = SQL_NTS;
// Bind the parameter.
SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_TYPE_DATE, 0, 0,
OpenDate, sizeof(OpenDate), &OpenDateLenOrInd);
// Place the date in the OpenDate variable. In addition to the escape
// sequence shown, it would also be possible to use either of the
// strings "{d '1995-01-15'}" and "15-Jan-1995", although the latter
// is data source-specific.
strcpy_s( (char*) OpenDate, _countof(OpenDate), "{d '1995-01-15'}");
// Execute the statement.
SQLExecDirect(hstmt, "UPDATE Orders SET OpenDate=? WHERE OrderID = 1023", SQL_NTS);
Тем не менее, обычно это более эффективно для привязки параметра непосредственно к структуре дат:
SQL_DATE_STRUCT OpenDate;
SQLINTEGER OpenDateInd = 0;
// Bind the parameter.
SQLBindParameter(hstmt, 1, SQL_PARAM_INPUT, SQL_C_TYPE_DATE, SQL_TYPE_DATE, 0, 0,
&OpenDate, 0, &OpenDateLen);
// Place the date in the dsOpenDate structure.
OpenDate.year = 1995;
OpenDate.month = 1;
OpenDate.day = 15;
// Execute the statement.
SQLExecDirect(hstmt, "UPDATE Employee SET OpenDate=? WHERE OrderID = 1023", SQL_NTS);
Чтобы определить, поддерживает ли драйвер escape-последовательности ODBC для литералов даты, времени или метки времени, приложение вызывает SQLGetTypeInfo. Если источник данных поддерживает тип данных даты, времени или метки времени, он также должен поддерживать соответствующую escape-последовательность.
Источники данных также могут поддерживать литералы даты и времени, определенные в спецификации ANSI SQL-92, которые отличаются от escape-последовательностей ODBC для литералов даты, времени или метки времени. Чтобы определить, поддерживает ли источник данных литералы ANSI, приложение вызывает SQLGetInfo с параметром SQL_ANSI_SQL_DATETIME_LITERALS.
Чтобы определить, поддерживает ли драйвер escape-последовательности ODBC для литерала интервалов, приложение вызывает SQLGetTypeInfo. Если источник данных поддерживает тип данных интервала даты и времени, он также должен поддерживать соответствующую escape-последовательность.
Источники данных также могут поддерживать литералы даты и времени, определенные в спецификации ANSI SQL-92, которые отличаются от escape-последовательностей ODBC для литералы интервала даты и времени. Чтобы определить, поддерживает ли источник данных литералы ANSI, приложение вызывает SQLGetInfo с параметром SQL_ANSI_SQL_DATETIME_LITERALS.