C en SQL : Intervalles de jours-heures

Les identificateurs des types de données ODBC C de l’intervalle de jour sont les suivants :

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

Le tableau suivant montre les types de données ODBC SQL vers lesquels les données d’intervalle C peuvent être converties. Pour obtenir une explication des colonnes et des termes de la table, consultez Conversion de données de C en types de données SQL.

Identificateur de type SQL	Test	SQLSTATE
SQL_CHAR[a] SQL_VARCHAR[a] SQL_LONGVARCHAR[a]	Longueur d’octet de >colonne = Longueur d’octet de caractère Longueur d’octet < de colonne Longueur d’octet du caractère[a] La valeur de données n’est pas un littéral d’intervalle valide	n/a 22001 22015
SQL_WCHAR[a] SQL_WVARCHAR[a] SQL_WLONGVARCHAR[a]	Longueur des caractères de >colonne = Longueur des caractères des données Longueur des caractères < de colonne Longueur du caractère des données[a] La valeur de données n’est pas un littéral d’intervalle valide	n/a 22001 22015
SQL_TINYINT[b] SQL_SMALLINT[b] SQL_INTEGER[b] SQL_BIGINT[b] SQL_NUMERIC[b] SQL_DECIMAL[b]	La conversion d’un intervalle à champ unique n’a pas entraîné la troncation de chiffres entiers La conversion a entraîné la troncation de chiffres entiers	n/a 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	La valeur des données a été convertie sans troncation des champs Un ou plusieurs champs de valeur de données ont été tronqués pendant la conversion	n/a 22015

[a] Tous les types de données d’intervalle C peuvent être convertis en type de données caractère.

[b] Si le champ de type dans la structure d’intervalles est tel que l’intervalle est un champ unique (SQL_DAY, SQL_HOUR, SQL_MINUTE ou SQL_SECOND), le type C d’intervalle peut être converti en n’importe quel numérique exact (SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT, SQL_DECIMAL ou SQL_NUMERIC).

La conversion par défaut d’un type C d’intervalle est en type SQL d’intervalle de jour correspondant.

Le pilote ignore la valeur de longueur/d’indicateur lors de la conversion des données du type de données interval C et suppose que la taille de la mémoire tampon de données correspond à la taille du type de données interval C. La valeur length/indicator est transmise dans l’argument StrLen_or_Ind dans SQLPutData et dans la mémoire tampon spécifiée avec l’argument StrLen_or_IndPtr dans SQLBindParameter. La mémoire tampon de données est spécifiée avec l’argument DataPtr dans SQLPutData et l’argument ParameterValuePtr dans SQLBindParameter.

L’exemple suivant montre comment envoyer des données C d’intervalle stockées dans la structure SQL_INTERVAL_STRUCT dans une colonne de base de données. La structure d’intervalles contient un intervalle DAY_TO_SECOND ; il sera stocké dans une colonne de base de données de type 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);