datetime2 (Transact-SQL)

Article
05/23/2023

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft Fabric Entrepôt dans Microsoft Fabric

Définit une date qui est associée à une heure de la journée au format 24 heures. datetime2 peut être considéré comme une extension du type datetime existant qui a une plus grande plage de dates, une plus grande précision de fraction par défaut et une précision spécifiée par l’utilisateur facultative.

Description de datetime2

Property	Valeur
Syntaxe	datetime2 [ (précision à la fraction de seconde) ]
Utilisation	DECLARE @MyDatetime2 datetime2(7) CREATE TABLE Table1 ( Column1 datetime2(7) )
Format de littéral de chaîne par défaut (utilisé pour le client de bas niveau)	AAAA-MM-JJ hh:mm:ss[.fractions de seconde] Pour plus d’informations, consultez la section « Compatibilité descendante pour les clients de bas niveau » ci-dessous.
Plage de dates	0001-01-01 à 9999-12-31 Du 1er janvier de l’an 1 au 31 décembre 9999
Plage temporelle	00:00:00 à 23:59:59.9999999
Plage de décalages de fuseau horaire	Aucun
Plages d'éléments	AAAA est un nombre de quatre chiffres, entre 0001 et 9999, qui représente une année. MM est un nombre à deux chiffres, entre 01 et 12, qui représente un mois dans l'année spécifiée. DD est un nombre à deux chiffres, entre 01 et 31 selon le mois, qui représente un jour du mois spécifié. hh est un nombre à deux chiffres, entre 00 et 23, qui représente l'heure. mm est un nombre à deux chiffres, entre 00 et 59, qui représente la minute. ss est un nombre à deux chiffres, entre 00 et 59, qui représente la seconde. n* est un nombre qui comprend entre zéro et sept chiffres, entre 0 et 9999999, qui représente les fractions de seconde. Dans Informatica, les fractions de seconde sont tronquées quand n > 3.
Longueur de caractère	19 positions au minimum (AAAA-MM-JJ hh:mm:ss) et 27 au maximum (AAAA-MM-JJ hh:mm:ss.0000000)
Précision, échelle	De 0 à 7 chiffres, avec une précision de 100 ns. La précision par défaut est de 7 chiffres. Dans Microsoft Fabric, il peut s’agir d’un entier compris entre 0 et 6, sans valeur par défaut. La précision doit être spécifiée dans Microsoft Fabric.
Taille de stockage ¹	6 octets pour une précision inférieure à 3. 7 octets pour une précision de 3 ou 4. Toutes les autres précisions nécessitent 8 octets.²
Précision	100 nanosecondes
Valeur par défaut	1900-01-01 00:00:00
Calendrier	Grégorien
Précision à la fraction de seconde définie par l'utilisateur	Oui
Prise en charge et conservation du décalage de fuseau horaire	Non
Prise en charge de l'heure d'été	Non

¹ Les valeurs fournies sont destinées à un rowstore non compressé. L’utilisation de la compression de données ou de columnstore peut altérer la taille de stockage pour chaque précision. De plus, la taille de stockage sur disque et en mémoire peut être différente. Par exemple, les valeurs datetime2 nécessitent toujours 8 octets en mémoire quand le mode batch est utilisé.

² Quand une valeur datetime2 est castée en valeur varbinary, un octet supplémentaire est ajouté à la valeur varbinary pour stocker la précision.

Pour afficher les métadonnées de type de données, consultez sys.systypes (Transact-SQL) ou TYPEPROPERTY (Transact-SQL). La précision et l'échelle sont variables pour certains types de données de date et d'heure. Pour obtenir la précision et l’échelle d’une colonne, consultez COLUMNPROPERTY (Transact-SQL), COL_LENGTH (Transact-SQL) ou sys.columns (Transact-SQL).

Formats de littéraux de chaîne pris en charge pour datetime2

Les tableaux suivants répertorient les formats de littéraux de chaîne ISO 8601 et ODBC pris en charge pour datetime2. Pour plus d’informations sur les formats alphabétique, numérique, non séparé et d’heure pour les parties de date et d’heure de datetime2, consultez date (Transact-SQL) et heure (Transact-SQL).

ISO 8601	Descriptions
AAAA-MM-JJThh:mm:ss[.nnnnnnn] AAAA-MM-JJThh:mm:ss[.nnnnnnn]	Ce format n'est pas affecté par les paramètres régionaux de session SET LANGUAGE et SET DATEFORMAT. T, le signe deux-points (:) et le point (.) sont inclus dans le littéral de chaîne, par exemple « 2007-05-02T19:58:47.1234567 ».

ODBC	Description
{ ts 'aaaa-mm-jj hh:mm:ss[.fractions de seconde]' }	Spécifique à l'API ODBC : Le nombre de chiffres à droite de la virgule décimale, qui représente les fractions de seconde, peut être spécifié de 0 jusqu'à 7 (100 nanosecondes).

Conformité ANSI et ISO 8601

La conformité ANSI et ISO 8601 de date et time s’applique à datetime2.

Compatibilité descendante pour les clients de bas niveau

Certains clients de bas niveau ne prennent pas en charge les types de données time, date, datetime2 et datetimeoffset. Le tableau suivant présente le type de mappage entre une instance de haut niveau de SQL Server et des clients de bas niveau.

Type de données SQL Server	Format de littéral de chaîne par défaut passé au client de bas niveau	ODBC de bas niveau	OLEDB de bas niveau	JDBC de bas niveau	SQLCLIENT de bas niveau
time	hh:mm:ss [.nnnnnnn]	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	String ou SqString
date	AAAA-MM-JJ	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	String ou SqString
datetime2	AAAA-MM-JJ hh:mm:ss[.nnnnnnn]	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	String ou SqString
datetimeoffset	AAAA-MM-JJ hh:mm:ss[.nnnnnnn] [+\|-]hh:mm	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	String ou SqString

Conversion de données date et time

Lorsque vous effectuez une conversion vers des types de données date et heure, SQL Server rejette toutes les valeurs qu'il ne peut identifier comme dates ou heures. Pour plus d’informations sur l’utilisation des fonctions CAST et CONVERT avec des données date et heure, consultez CAST et CONVERT (Transact-SQL)

Conversion d’autres types date et time en type de données datetime2

Cette section décrit ce qui se produit quand d’autres types de données date et time sont convertis en type de données datetime2.

Dans le cas d’une conversion à partir de date, l’année, le mois et le jour sont copiés. Le composant heure est défini sur 00:00:00.0000000. Le code suivant montre les résultats de la conversion d'une valeur date en valeur datetime2.

DECLARE @date date = '12-21-16';
DECLARE @datetime2 datetime2 = @date;

SELECT @datetime2 AS '@datetime2', @date AS '@date';
  
--Result  
--@datetime2                  @date
----------------------------- ----------
--2016-12-21 00:00:00.0000000 2016-12-21

Dans le cas d’une conversion à partir de time(n), le composant heure est copié et le composant date est défini sur « 1900-01-01 ». L'exemple suivant montre les résultats de la conversion d'une valeur time(7) en valeur datetime2.

DECLARE @time time(7) = '12:10:16.1234567';
DECLARE @datetime2 datetime2 = @time;

SELECT @datetime2 AS '@datetime2', @time AS '@time';
  
--Result  
--@datetime2                  @time
----------------------------- ----------------
--1900-01-01 12:10:16.1234567 12:10:16.1234567

Dans le cas d’une conversion à partir de smalldatetime, les heures et les minutes sont copiées. Les secondes et fractions de seconde sont définies sur 0. Le code suivant montre les résultats de la conversion d'une valeur smalldatetime en valeur datetime2.

DECLARE @smalldatetime smalldatetime = '12-01-16 12:32';
DECLARE @datetime2 datetime2 = @smalldatetime;

SELECT @datetime2 AS '@datetime2', @smalldatetime AS '@smalldatetime'; 
  
--Result  
--@datetime2                  @smalldatetime
----------------------------- -----------------------
--2016-12-01 12:32:00.0000000 2016-12-01 12:32:00

Dans le cas d’une conversion à partir de datetimeoffset(n), les composants date et heure sont copiés. Le fuseau horaire est tronqué. L'exemple suivant montre les résultats de la conversion d'une valeur datetimeoffset(7) en valeur datetime2.

DECLARE @datetimeoffset datetimeoffset(7) = '2016-10-23 12:45:37.1234567 +10:0';
DECLARE @datetime2 datetime2 = @datetimeoffset;

SELECT @datetime2 AS '@datetime2', @datetimeoffset AS '@datetimeoffset'; 
  
--Result  
--@datetime2                  @datetimeoffset
----------------------------- ----------------------------------
--2016-10-23 12:45:37.1234567 2016-10-23 12:45:37.1234567 +10:00

Dans le cas d’une conversion à partir de datetime, la date et l’heure sont copiées. La précision de fraction est étendue à 7 chiffres. L'exemple suivant montre les résultats de la conversion d'une valeur datetime en valeur datetime2.

DECLARE @datetime datetime = '2016-10-23 12:45:37.333';
DECLARE @datetime2 datetime2 = @datetime;

SELECT @datetime2 AS '@datetime2', @datetime AS '@datetime';
   
--Result  
--@datetime2                  @datetime
------------------------- ---------------------------
--2016-10-23 12:45:37.3333333 2016-10-23 12:45:37.333

Notes

Sous le niveau de compatibilité de base de données 130, les conversions implicites des types de données datetime en datetime2 offrent une meilleure précision en prenant en compte les fractions de milliseconde, ce qui génère différentes valeurs converties, comme illustré dans l’exemple ci-dessus. Utilisez un transtypage explicite vers le type de données datetime2 chaque fois qu’il existe un scénario de comparaison mixte entre les types de données datetime et datetime2. Pour plus d’informations, consultez cet article du Support technique Microsoft.

Conversion de littéraux de chaîne en datetime2

Les conversions de littéraux de chaîne en types de date et d'heure sont autorisées si toutes les parties des chaînes sont dans des formats valides. Sinon, une erreur d'exécution est déclenchée. Les conversions implicites ou explicites qui ne spécifient pas de style à partir de types de date et d'heure en littéraux de chaîne seront au format par défaut de la session active. Le tableau suivant montre les règles de conversion d’un littéral de chaîne en type de données datetime2.

Littéral de chaîne d'entrée	datetime2(n)
ODBC DATE	Les littéraux de chaîne ODBC sont mappés au type de données datetime. Toute opération d’affectation de littéraux ODBC DATETIME dans des types datetime2 provoque une conversion implicite entre datetime et ce type, comme défini par les règles de conversion.
ODBC TIME	Consultez la règle DATE ODBC précédente.
ODBC DATETIME	Consultez la règle DATE ODBC précédente.
DATE uniquement	La partie TIME a pour valeur par défaut 00:00:00.
TIME uniquement	La partie DATE a pour valeur par défaut 1900-1-1.
TIMEZONE uniquement	Les valeurs par défaut sont fournies.
DATE + TIME	Simple
DATE + TIMEZONE	Non autorisé.
TIME + TIMEZONE	La partie DATE a pour valeur par défaut 1900-1-1. L'entrée TIMEZONE est ignorée.
DATE + TIME + TIMEZONE	Le DATETIME local sera utilisé.

Exemples

L’exemple suivant compare les résultats de la conversion d’une chaîne en chaque type de données date et time.

SELECT   
     CAST('2007-05-08 12:35:29. 1234567 +12:15' AS time(7)) AS 'time'   
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS date) AS 'date'   
    ,CAST('2007-05-08 12:35:29.123' AS smalldatetime) AS   
        'smalldatetime'   
    ,CAST('2007-05-08 12:35:29.123' AS datetime) AS 'datetime'   
    ,CAST('2007-05-08 12:35:29. 1234567 +12:15' AS datetime2(7)) AS   
        'datetime2'  
    ,CAST('2007-05-08 12:35:29.1234567 +12:15' AS datetimeoffset(7)) AS   
        'datetimeoffset';

Voici le jeu de résultats obtenu.

Type de données	Output
time	12:35:29.1234567
date	2007-05-08
smalldatetime	2007-05-08 12:35:00
datetime	2007-05-08 12:35:29.123
datetime2	2007-05-08 12:35:29.1234567
datetimeoffset	2007-05-08 12:35:29.1234567 +12:15

Voir aussi

CAST et CONVERT (Transact-SQL)