Liaisons et conversions (OLE DB)

Cette section explique comment réaliser des conversions entre des valeurs datetime et datetimeoffset. Les conversions décrites dans cette section sont soit déjà fournies par OLE DB, soit une une extension cohérente de ce dernier.

Le format des littéraux et des chaînes pour les dates et les heures dans OLE DB suit généralement la norme ISO et ne dépend pas des paramètres régionaux du client. Une exception est DBTYPE_DATE où la norme est OLE Automation. Toutefois, du fait que SQL Server Native Client effectue uniquement des conversions entre des types lorsque des données sont transmises vers ou depuis le client, il n'existe aucun moyen de contraindre SQL Server Native Client à effectuer des conversions entre DBTYPE_DATE et un format de chaîne. Sinon, les chaînes utilisent les formats suivants (le texte entre crochets indique un élément facultatif) :

• Le format des chaînes datetime et datetimeoffset est le suivant :

  yyyy-mm-dd[ hh:mm:ss[.9999999][ ± hh:mm]]

• Le format des chaînes time est le suivant :

  hh:mm:ss[.9999999]

• Le format des chaînes date est le suivant :

  yyyy-mm-dd

Les conversions de chaînes autorisent une souplesse en matière d'espace et de largeur de champ. Pour plus d'informations, consultez la section « Formats de données : chaînes et littéraux » dans Prise en charge du type de données pour les améliorations de Date/Heure OLE DB.

Les règles suivantes sont les règles générales de conversion :

• Lorsqu'une chaîne est convertie en type date/heure, la chaîne est d'abord analysée en tant que littéral ISO. En cas d'échec, la chaîne est analysée comme un littéral de date OLE doté de composants heure.

• Si aucune heure n'est fournie mais le récepteur peut stocker l'heure, l'heure est définie avec la valeur zéro. Si aucune date n'est fournie mais le récepteur peut stocker une date, la date définie est la date actuelle qui utilise les conversions ISO ou bien 1899-12-30 qui utilise les conversions OLE.

• Si aucun fuseau horaire n'est fourni dans le type de données que le client utilise mais si le serveur peut stocker le fuseau, les données du client sont supposées apparaître dans le fuseau horaire du client.

• Si aucun fuseau horaire n'est fourni au serveur mais le client dispose d'informations sur les fuseaux, le fuseau horaire UTC est adopté. Ce comportement diffère de celui du serveur.

• Si l'heure est fournie mais le récepteur ne peut pas la stocker, le composant heure est ignoré.

• Si la date est fournie mais le récepteur ne peut pas la stocker, le composant date est ignoré.

• En cas de troncation des secondes ou des fractions de seconde lors de la conversion du client au serveur, DB_E_ERRORSOCCURRED est retourné et l'état DBSTATUS_E_DATAOVERFLOW est défini.

• En cas de troncation des secondes ou des fractions de seconde lors de la conversion du serveur au client, DBSTATUS_S_TRUNCATED est défini