Styles de date et d'heure
Lorsque expression est un type de données de date ou d'heure, style peut être l'une des valeurs présentées dans le tableau ci-dessous. Les autres valeurs sont traitées comme étant 0. SQL Server prend en charge le format de date en style arabe, à l'aide de l'algorithme koweïtien.
|
Sans siècle (aa) (1)
|
Avec siècle (aaaa)
|
Standard
|
Entrée/Sortie (3)
|
| - | 0 ou 100 (1, 2) | Par défaut | mois jj aaaa hh:miAM (ou PM) |
| 1 | 101 | États-Unis | mm/jj/aaaa |
| 2 | 102 | ANSI | aa.mm.jj |
| 3 | 103 | Anglais/Français | jj/mm/aaaa |
| 4 | 104 | Allemand | jj.mm.aa |
| 5 | 105 | Italien | jj-mm-aa |
| 6 | 106 (1) | - | jj mois aa |
| 7 | 107 (1) | - | mois jj, aa |
| 8 | 108 | - | hh:mi:ss |
| - | 9 ou 109 (1, 2) | Valeur par défaut + millièmes de secondes | mois jj aaaa hh:mi:ss:mmmAM (ou PM) |
| 10 | 110 | USA | mm-jj-aa |
| 11 | 111 | Japon | aa/mm/jj |
| 12 | 112 | ISO | aammjj aaaammjj |
| - | 13 ou 113 (1, 2) | Valeur par défaut Europe + millièmes de secondes | jj mois aaaa hh:mi:ss:mmm (24h) |
| 14 | 114 | - | hh:mi:ss:mmm(24h) |
| - | 20 ou 120 (2) | ODBC canonique | aaaa-mm-jj hh:mi:ss (24h) |
| - | 21 ou 121 (2) | ODBC canonique (avec millièmes de secondes) | aaaa-mm-jj hh:mi:ss.mmm (24h) |
| - | 126 (4) | ISO8601 | aaaa-mm-jjThh:mi:ss.mmm (sans espace) |
| - | 127(6, 7) | ISO8601 avec fuseau horaire Z. | jj-mm-aaaaThh:mi:ss.mmmZ (sans espaces) |
| - | 130 (1, 2) | Hijri (5) | jj mois aaaa hh:mi:ss:mmmAM |
| - | 131 (2) | Hijri (5) | jj/mm/aa hh:mi:ss:mmmAM |
1 Ces valeurs de style retournent des résultats non déterministes. Inclut tous les styles (aa, c'est-à-dire sans siècle) et un sous-ensemble de styles (aaaa, c'est-à-dire avec siècle).
2 Valeurs par défaut (style 0 ou 100, 9 ou 109, 13 ou 113, 20 ou 120, ou encore 21 ou 121) renvoient toujours le siècle (aaaa).
3 Entrée lors de la conversion en données de type datetime ; ou encore, sortie lors de la conversion en données de type caractère.
4 Conçue pour le langage XML. Pour la conversion de données datetime ou smalldatetime en données de type caractère, le format de sortie étant celui décrit dans le tableau précédent.
5 Hijri est un système calendaire possédant plusieurs variations. SQL Server utilise l'algorithme Kuwaiti.
Important : |
|---|
|
Par défaut, SQL Server interprète les années à deux chiffres par rapport à l'année de coupure 2049. C'est-à-dire que l'année 49 est interprétée comme 2049 et l'année 50 comme 1950. De nombreuses applications clientes, comme celles qui s'appuient sur les objets Automation, utilisent l'année de coupure 2030. SQL Server dispose d'une option de configuration (two digit year cutoff) qui permet de modifier l'année de coupure utilisée par SQL Server et garantit ainsi le traitement cohérent des dates. Nous vous recommandons d'utiliser la fonctionnalité d'années exprimées sur quatre chiffres. |
6 Prise en charge uniquement lors de la conversion de données de type caractère en type datetime ou smalldatetime. Lorsque des données de caractères représentant des composants de date ou d'heure uniquement sont converties en type de données datetime ou smalldatetime, le composant d'heure non spécifié est défini à 00:00:00.000, et le composant de date non spécifié est défini à 1900-01-01.
7 L'indicateur de fuseau horaire facultatif Z facilite le mappage des valeurs datetime XML qui possèdent des informations de fuseau horaire avec les valeurs SQL Server datetime dépourvues d'informations de fuseau horaire. Z est l'indicateur du fuseau horaire UTC-0. Les autres fuseaux horaires sont indiqués avec le décalage HH:MM dans la direction + ou -. Exemple : 2006-12-12T23:45:12-08:00.
Lorsque vous convertissez des données smalldatetime en données de type caractère, les styles comportant les secondes ou les millièmes de secondes affichent des zéros à ces positions. Si vous convertissez des données de type datetime ou smalldatetime, vous pouvez supprimer les parties non requises de la date en spécifiant la longueur de type de données char ou varchar appropriée.
Lorsque vous effectuez une conversion en datetimeoffset de données caractères avec un style qui inclut une heure, un décalage de fuseau horaire est ajouté au résultat.
Styles float et real
Lorsque expression est float ou real, style peut être l'une des valeurs présentées dans le tableau ci-dessous. Les autres valeurs sont traitées comme étant 0.
|
Valeur
|
Résultat
|
| 0 (valeur par défaut) | 6 chiffres maximum. À utiliser pour la notation scientifique si nécessaire. |
| 1 | Toujours 8 chiffres. À utiliser obligatoirement pour la notation scientifique. |
| 2 | Toujours 16 chiffres. À utiliser obligatoirement pour la notation scientifique. |
| 126, 128, 129 | Incluses pour des raisons d'héritage et peuvent être abandonnées dans une version ultérieure. |
Styles money et smallmoney
Lorsque expression est money ou smallmoney, style peut être l'une des valeurs présentées dans le tableau ci-dessous. Les autres valeurs sont traitées comme étant 0.
|
Valeur
|
Résultat
|
| 0 (valeur par défaut) | Pas de virgule tous les trois chiffres à gauche du point décimal, et deux chiffres à droite de celui-ci. Par exemple, 4235.98. |
| 1 | Insertion d'une virgule tous les trois chiffres à gauche du point décimal, et deux chiffres à droite de celui-ci. Par exemple 3,510.92. |
| 2 | Pas de virgule tous les trois chiffres à gauche du point décimal, et quatre chiffres à droite de celui-ci. Par exemple 4235.9819. |
| 126 | Équivalent du style 2 lors de la conversion en char(n) ou varchar(n) |
Styles xml
Lorsque expression est xml, style peut être l'une des valeurs présentées dans le tableau ci-dessous. Les autres valeurs sont traitées comme étant 0.
|
Valeur
|
Résultat
|
| 0 (valeur par défaut) | Utilisez le comportement d'analyse par défaut permettant de supprimer les espaces non significatifs et n'autorisant pas de sous-ensemble DTD interne. Remarque : |
|---|
|
Si vous effectuez une conversion vers le type de données xml, les espaces non significatifs sont gérés différemment par SQL Server que pour les documents au format XML 1.0. Pour plus d'informations, consultez Génération d'instances XML. |
|
| 1 | Maintient des espaces non significatifs. Ce paramètre de style définit la gestion par défaut de xml:space pour qu'elle soit plutôt équivalente à l'option xml:space="preserve". |
| 2 | Activation du traitement limité de sous-ensembles DTD internes. Si cette option est activée, le serveur peut utiliser les informations suivantes fournies dans un sous-ensemble DTD interne afin de procéder à des opérations d'analyse autres que celles de validation des données. -
Les valeurs par défaut concernant les attributs sont alors appliquées.
-
Les références à des entités internes sont résolues et développées.
-
Le modèle de contenu DTD fait ensuite l'objet d'une vérification syntaxique.
L'analyseur ignore les sous-ensembles DTD externes. Il n'évalue cependant pas la déclaration des balises XML au niveau de l'attribut standalone pour vérifier s'il est défini sur yes ou no, mais analyse cependant l'instance XML comme s'il s'agissait d'un document autonome. |
| 3 | Maintien des espaces non significatifs et activation du traitement limité de sous-ensembles DTD internes. |
Styles Binary
Lorsque expression est binary(n), varbinary(n), char(n) ou varchar(n), style peut être l'une des valeurs présentées dans le tableau ci-dessous. Les valeurs de style qui ne sont pas répertoriées dans le tableau retournent une erreur.
|
Valeur
|
Résultat
|
| 0 (par défaut) | Traduit des caractères ASCII en octets binaires ou des octets de binaire en caractères ASCII. Chaque caractère ou octet est converti 1:1. Si le data_type est un type binaire, les caractères 0x sont ajoutés à gauche du résultat. |
| 1, 2 | Si le data_type est un type binaire, l'expression doit être une expression de caractères. L'expression doit être composée d'un nombre pair de chiffres hexadécimaux (0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F, a, b, c, d, e, f). Si le style a la valeur 1, les caractères 0x doivent être les deux premiers caractères de l'expression. Si l'expression contient un nombre impair de caractères ou si l'un des caractères n'est pas valide, une erreur est générée. Si la longueur de l'expression convertie est supérieure à la longueur du data_type, le résultat est tronqué à droite. Les data_types de longueur fixe qui sont plus longs que le résultat converti se voient ajouter des zéros à droite du résultat. Si le data_type est un type caractère, l'expression doit être une expression binaire. Chaque caractère binaire est converti en deux caractères hexadécimaux. Si la longueur de l'expression convertie est supérieure à la longueur du data_type, le résultat est tronqué à droite. Si le data_type est un type caractère de taille fixe et que la longueur du résultat converti est inférieure à la longueur du data_type, des espaces sont ajoutés à droite de l'expression convertie pour conserver un nombre pair de chiffres hexadécimaux. Des caractères 0x sont ajoutés à gauche du résultat converti pour style 1. |
Conversions implicites
Une conversion implicite est une conversion pour laquelle il n'est pas nécessaire de spécifier les fonctions CAST ou CONVERT. À l'inverse, une conversion explicite requiert que la fonction CAST ou CONVERT soit indiquée. L'illustration ci-dessous reprend toutes les conversions de types de données explicites et implicites autorisées pour les types de données SQL Server fournis par le système. Ceux-ci comprennent notamment xml, bigint et sql_variant. Aucune conversion implicite d'attribution de valeur n'est effectuée à partir du type de données sql_variant, mais une conversion implicite vers sql_variant existe.
Lorsque vous effectuez une conversion entre datetimeoffset et les types de caractère char, varchar, nchar ou nvarchar, la partie du décalage de fuseau horaire convertie doit toujours comporter des chiffres doubles pour HH et pour MM, par exemple : -08:00.
Remarque : |
|---|
|
Les données Unicode utilisent toujours un nombre pair d'octets et vous devez par conséquent faire attention lorsque vous convertissez des données de type binary ou varbinary vers ou à partir des types de données pris en charge par Unicode. Ainsi, la conversion suivante retourne la valeur hexadécimale 4100 et non pas 41 : SELECT CAST(CAST(0x41 AS nvarchar) AS varbinary). |
Types de données de valeur élevée
Les types de données correspondant à des valeurs élevées font preuve du même comportement de conversion, à la fois implicite et explicite, que leur contreparties de poids plus faible, plus particulièrement en ce qui concerne les types varchar, nvarchar et varbinary. Vous devez cependant prendre en compte les recommandations suivantes :
-
La conversion du type image en varbinary(max) et vice versa est une conversion implicite ; il en va de même pour la conversion entre text et varchar(max) d'une part et ntext et nvarchar(max) d'autre part.
-
La conversion de types de données de valeurs élevées, comme c'est le cas pour le type varchar(max), en type équivalent mais de poids plus faible, par exemple varchar, reste aussi une conversion implicite, mais la valeur trop grande risque d'être tronquée si elle dépasse la longueur indiquée autorisée pour le type de données de poids dont l'espace mémoire alloué reste plus modeste.
-
Les conversions de varchar, de nvarchar ou de varbinary à leur équivalent plus volumineux en espace mémoire sont également opérées de façon implicite.
-
Enfin, les conversions du type de données sql_variant en type plus conséquent correspondent cependant à une conversion explicite.
-
Il reste à savoir que les types de données de valeurs élevées ne peuvent pas être convertis en sql_variant.
Pour plus d'informations sur la façon de convertir les types définis par l'utilisateur créés dans le CLR (Common Language Runtime) Microsoft .NET Framework, consultez Exécution d'opérations sur des types définis par l'utilisateur. Pour plus d'informations sur la façon d'effectuer une conversion à partir du type de données xml, consultez Génération d'instances XML.
Type de données xml
Lors de la conversion explicite ou implicite du type de données xml en type de données de chaîne ou de caractères, le contenu du type de données xml est sérialisé par rapport à un ensemble de règles. Pour plus d'informations sur ces règles, consultez Sérialisation des données XML. Pour plus d'informations sur la conversion de XML en type CLR défini par l'utilisateur, consultez Exécution d'opérations sur des types définis par l'utilisateur. Pour plus d'informations sur la façon d'effectuer une conversion à partir d'autres types de données vers le type de données xml, consultez Génération d'instances XML.
Types de données text et image
Les types de données text et image ne prennent pas en charge la conversion automatique de types de données. Vous pouvez explicitement convertir des données de type text en type caractère et des données de type image en binary ou en varbinary, mais la longueur maximale admise est de 8 000 octets. Si vous tentez une conversion non prévue, par exemple une expression de type caractère incluant des lettres et convertie en type int, SQL Server retourne alors un message d'erreur.
Classement des résultats
Lorsque l'entrée et la sortie de CAST ou CONVERT sont des chaînes de caractères, l'entrée et la sortie présentent les mêmes classement et étiquette de classement. Si l'entrée n'est pas une chaîne de caractères, la sortie présente le classement par défaut de la base de données et une étiquette de classement de contrainte par défaut. Pour plus d'informations, consultez Priorité de classement (Transact-SQL).
Pour attribuer un classement différent à la sortie, appliquez la clause COLLATE à l'expression de résultat de la fonction CAST ou CONVERT. Exemple :
SELECT CAST('abc' AS varchar(5)) COLLATE French_CS_AS
Troncation et arrondi des résultats
Lors de la conversion d'une expression de type binaire ou caractère (char, nchar, nvarchar, varchar, binary ou varbinary) en une expression d'un type différent, les données peuvent être tronquées ou partiellement affichées, ou une erreur est retournée si le résultat est trop court pour pouvoir être affiché. Une expression convertie en donnée de type char, varchar, nchar, nvarchar, binary et varbinary est par conséquent tronquée, sauf pour les conversions répertoriées dans le tableau suivant.
|
Du type de données
|
Au type de données
|
Résultat
|
| int, smallint ou tinyint | char | * |
| | varchar | * |
| | nchar | E |
| | nvarchar | E |
| money, smallmoney, numeric, decimal, float ou real | char | E |
| | varchar | E |
| | nchar | E |
| | nvarchar | E |
* = Expression résultante trop courte pour être affichée. E = Erreur retournée parce que l'expression résultante est trop courte pour être affichée.
SQL Server garantit que seules des conversions en boucle, c'est-à-dire qui convertissent un type de données en un autre puis à nouveau en son type d'origine, restitueront les mêmes valeurs d'une version à l'autre de l'application. L'exemple suivant illustre un tel cas de figure :
DECLARE @myval decimal (5, 2)
SET @myval = 193.57
SELECT CAST(CAST(@myval AS varbinary(20)) AS decimal(10,5))
-- Or, using CONVERT
SELECT CONVERT(decimal(10,5), CONVERT(varbinary(20), @myval))
Remarque : |
|---|
|
Ne tentez pas d'élaborer des valeurs de type binary destinées à une conversion dans un type de la catégorie numérique. SQL Server ne peut en effet pas assurer que des données de type decimal ou numeric converties en binary reviendront au même entre les différentes versions de SQL Server. |
L'exemple suivant illustre une expression résultante trop petite pour être affichée.
USE AdventureWorks;
GO
SELECT c.FirstName, c.LastName, SUBSTRING(c.Title, 1, 25) AS Title, CAST(e.SickLeaveHours AS char(1)) AS 'Sick Leave'
FROM HumanResources.Employee e JOIN Person.Contact c ON e.EmployeeID = c. ContactID
WHERE NOT EmployeeID >5
Voici l'ensemble des résultats.
FirstName LastName Title Sick Leave
--------- --------- ------------------- -----------
Gustavo Achong Mr. *
Catherine Abel Ms. *
Kim Abercrombie Ms. *
Humberto Acevedo Sr. *
Pilar Ackerman Sra. *
(5 row(s) affected)
Si vous convertissez des données dont le type diffère sur l'emplacement de la virgule, la valeur résultante peut parfois être tronquée, parfois être arrondie. Le tableau suivant illustre ce comportement.
|
De
|
En
|
Comportement
|
| numeric | numeric | Arrondi |
| numeric | int | Tronqué |
| numeric | money | Arrondi |
| money | int | Arrondi |
| money | numeric | Arrondi |
| float | int | Truncate |
| float | numeric | Arrondi |
| float | datetime | Arrondi |
| datetime | int | Arrondi |
Par exemple, le résultat découlant de la conversion suivante est 10 :
SELECT CAST(10.6496 AS int)
Lors des conversions entre divers types de données dans lesquelles les types de données cibles comptent moins de chiffres décimaux que les types de données sources, la valeur obtenue est arrondie. Par exemple, le résultat découlant de la conversion suivante est $10.3497 :
SELECT CAST(10.3496847 AS money)
SQL Server retourne un message d'erreur lorsque des données de type char, nchar, varchar ou nvarchar sont converties en données int, float, numeric ou decimal, ou lorsqu'une chaîne vide (« ») est convertie en données de type numeric ou decimal.
Certaines conversions de valeurs datetime sont non déterministes dans SQL Server 2005 et versions ultérieures
Dans SQL Server 2000, les conversions de chaînes en dates et heures sont marquées comme étant déterministes. Toutefois, cela n'est pas le cas pour les styles répertoriés dans le tableau ci-dessous. Pour ces styles, les conversions dépendent des paramètres de langue. SQL Server 2005 et versions ultérieures marquent ces conversions comme non déterministes.
Le tableau ci-dessous répertorie les styles pour lesquels la conversion chaîne-datetime est non déterministe.
| Tous les styles inférieurs à 1001 | 106 |
| 107 | 109 |
| 113 | 130 |
1 À l'exception des styles 20 et 21