datetime2 (Transact-SQL)

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 fractionnaire par défaut et une précision spécifiée par l'utilisateur facultative.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle, Base de données SQL Windows Azure (version initiale via la version actuelle.

Description de datetime2

Propriété	Valeur
Syntaxe	datetime2 [ (fractional seconds precision) ]
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 » qui suit.
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.
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.
Taille de stockage	6 octets pour des précisions inférieures à 3 chiffres ; 7 octets pour des précisions égales à 3 et 4 chiffres. Toutes les autres précisions requièrent 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

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 time (Transact-SQL).

ISO 8601	Descriptions
YYYY-MM-DDThh:mm:ss[. nnnnnnn] YYYY-MM-DDThh: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	YYYY-MM-DD hh:mm:ss[. nnnnnnn]	SQL_WVARCHAR ou SQL_VARCHAR	DBTYPE_WSTR ou DBTYPE_STR	Java.sql.String	String ou SqString
datetimeoffset	YYYY-MM-DD 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 de date et d'heure

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 de date et d'heure, consultez CAST et CONVERT (Transact-SQL).

Conversion de types de données datetime2 vers d'autres types de date et d'heure

Le tableau suivant décrit ce qui se produit lorsqu'un type de données datetime2 est converti en d'autres types de données de date et d'heure.

Type de données vers lequel effectuer la conversion	Détails de conversion
date	Le jour, le mois et l'année sont copiés. Le composant heure est défini sur 00:00:00.000. Le code suivant montre les résultats de la conversion d'une valeur date en valeur datetime. DECLARE @date date = '12-21-05'; DECLARE @datetime datetime = @date; SELECT @datetime AS '@datetime', @date AS '@date'; --Result --@datetime @date ------------------------- ---------- --2005-12-21 00:00:00.000 2005-12-21
time(n)	Le composant heure est copié et le composant date est défini sur '1900-01-01'. Lorsque la précision de fraction de la valeur time(n) est supérieure à trois chiffres, la valeur est tronquée en conséquence. L'exemple suivant montre les résultats de la conversion d'une valeur time(4) en valeur datetime. DECLARE @time time(4) = '12:10:05.1237'; DECLARE @datetime datetime = @time; SELECT @datetime AS '@datetime', @time AS '@time'; --Result --@datetime @time ------------------------- ------------- --1900-01-01 12:10:05.123 12:10:05.1237 -- --(1 row(s) affected)
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 datetime. DECLARE @smalldatetime smalldatetime = '12-01-01 12:32'; DECLARE @datetime datetime = @smalldatetime; SELECT @datetime AS '@datetime', @smalldatetime AS '@smalldatetime'; --Result --@datetime @smalldatetime ------------------------- ----------------------- --2001-12-01 12:32:00.000 2001-12-01 12:32:00 -- --(1 row(s) affected)
datetimeoffset(n)	Les composants date et heure sont copiés. Le fuseau horaire est tronqué. Lorsque la précision de fraction de la valeur datetimeoffset(n) est supérieure à trois chiffres, la valeur est tronquée en conséquence. L'exemple suivant montre les résultats de la conversion d'une valeur datetimeoffset(4) en valeur datetime. DECLARE @datetimeoffset datetimeoffset(4) = '1968-10-23 12:45:37.1234 +10:0'; DECLARE @datetime datetime = @datetimeoffset; SELECT @datetime AS '@datetime', @datetimeoffset AS '@datetimeoffset'; --Result --@datetime @datetimeoffset ------------------------- ------------------------------ --1968-10-23 12:45:37.123 1968-10-23 12:45:37.1237 +01:0 -- --(1 row(s) affected)
datetime2(n)	La date et l'heure sont copiées. Lorsque la précision de fraction de la valeur datetime2(n) est supérieure à trois chiffres, la valeur est tronquée en conséquence. L'exemple suivant montre les résultats de la conversion d'une valeur datetime2(4) en valeur datetime. DECLARE @datetime2 datetime2(4) = '1968-10-23 12:45:37.1237'; DECLARE @datetime datetime = @datetime2; SELECT @datetime AS '@datetime', @datetime2 AS '@datetime2'; --Result --@datetime @datetime2 ------------------------- ------------------------ --1968-10-23 12:45:37.123 1968-10-23 12:45:37.1237 -- --(1 row(s) affected)

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 sur le type de données datetime. Toute opération d'affectation de littéraux ODBC DATETIME en 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 l'ensemble des résultats.

Type de données	Sortie
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

Référence

CAST et CONVERT (Transact-SQL)