Données de date et d’heure

SQL Server 2008 a introduit des types de données distincts pour la date et l’heure, et développé des types de données avec une plus grande portée, précision et prise en charge des fuseaux horaires. Utilisez le package NuGet Microsoft.Data.SqlClient pour accéder à ces types de données à partir d’applications clientes. Pour les exemples de cet article, importez Microsoft.Data.SqlClient et System.Data en C# ou Visual Basic. Les types de valeurs SQL courants figurent dans System.Data.SqlTypes.

Les versions de SQL Server antérieures à SQL Server 2008 avaient uniquement deux types de données pour travailler avec des valeurs de date et heure : datetime et smalldatetime. Ces deux types de données contiennent à la fois les valeurs de date et d’heure, ce qui rend difficile l’utilisation de l’une sans l’autre. De plus, seules les dates postérieures à l'introduction du calendrier grégorien en Angleterre en 1753 sont prises en charge par ces types. Une autre limitation est que ces types de données plus anciens ne prennent pas en charge les fuseaux horaires, ce qui rend difficile l’utilisation de données provenant de plusieurs fuseaux horaires.

Pour plus d'informations sur les types de données de date et d’heure dans SQL Server, consultez Types de données et fonctions de date et d’heure.

Types de données de date et d'heure introduits dans SQL Server 2008

Le tableau suivant décrit les nouveaux types de données de date et heure.

Format et ordre de la date

La façon dont SQL Server analyse les valeurs de date et heure dépend non seulement de la version du système de type et de la version du serveur, mais également des paramètres de format et de langue par défaut du serveur. Une chaîne de date qui fonctionne pour les formats de date d’une langue peut ne pas être reconnaissable si la requête est exécutée par une connexion qui utilise des paramètres de format de date et de langue différents.

L’instruction Transact-SQL SET LANGUAGE définit implicitement le DATEFORMAT qui détermine l’ordre des parties de date. Vous pouvez utiliser l’instruction SET DATEFORMAT Transact-SQL sur une connexion pour lever l’ambiguïté des valeurs de date en ordonnant les éléments de la date dans l’ordre MDY, DMY, YMD, YDM, MYD ou DYM.

Si vous ne spécifiez aucun DATEFORMAT pour la connexion, SQL Server utilise la langue par défaut associée à la connexion. Par exemple, une chaîne de date de « 01/02/03 » serait interprétée comme MDY (le 2 janvier 2003) sur un serveur avec un paramètre de langue d’anglais des États-Unis et comme DMY (1er février 2003) sur un serveur avec un paramètre de langue anglaise britannique. L’année est déterminée à l’aide de la règle de coupure d’année de SQL Server, qui définit la date limite pour l’attribution de la valeur du siècle. Pour plus d’informations, consultez Option de coupure des années à deux chiffres.

Pour plus d’informations sur la manière dont SQL Server interprète les données de date et d’heure, consultez Utilisation des donnée de date et d’heure.

Types de données et paramètres de date/heure

Les énumérations suivantes ont été ajoutées à SqlDbType pour prendre en charge les nouveaux types de données de date et heure.

• SqlDbType.Date

• SqlDbType.Time

• SqlDbType.DateTime2

• SqlDbType.DateTimeOffset

Pour spécifier le type de données de l’objet SqlParameter , utilisez l’une des valeurs d’énumération précédentes SqlDbType .

Pour spécifier le type de paramètre de manière générique, définissez la DbType propriété sur la valeur d’énumération DbType . Les valeurs suivantes DbType prennent en charge les types de données datetimeoffset et datetime2 :

• DbType.DateTime2

• DbType.DateTimeOffset

Ces nouvelles énumérations complètent les énumérations Date, Time et DateTime qui existaient dans les versions antérieures du .NET Framework.

Le type de fournisseur de données .NET Framework d'un objet paramètre est déduit du type .NET Framework de la valeur de l'objet paramètre, ou du DbType de l'objet paramètre. Aucun nouveau type de données System.Data.SqlTypes n’a été introduit pour prendre en charge les nouveaux types de données de date et heure. Le tableau suivant décrit les mappages entre les types de données de date et heure SQL Server 2008 et les types de données CLR.

SqlParameter : Propriétés

Le tableau suivant décrit les propriétés de SqlParameter qui sont pertinentes pour les types de données de date et heure.

Création de paramètres

Créez des objets SqlParameter avec le constructeur, ou appelez la méthode Add sur la collection Parameters de la commande. La Add méthode accepte des arguments de constructeur ou un objet de paramètre existant.

Les sections suivantes de cette rubrique fournissent des exemples de spécification des paramètres de date et heure. Pour obtenir d’autres exemples d’utilisation des paramètres, consultez Configuration des paramètres et des types de données des paramètres et Paramètres DataAdapter.

Exemple relatif au paramètre date

Le fragment de code suivant montre comment spécifier un paramètre date.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Date";
parameter.SqlDbType = SqlDbType.Date;
parameter.Value = "2007/12/1";

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Date"
parameter.SqlDbType = SqlDbType.Date
parameter.Value = "2007/12/1"

Exemple relatif au paramètre time

Le fragment de code suivant montre comment spécifier un paramètre time.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@time";
parameter.SqlDbType = SqlDbType.Time;
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay;

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Time"
parameter.SqlDbType = SqlDbType.Time
parameter.Value = DateTime.Parse("23:59:59").TimeOfDay

Exemple relatif au paramètre datetime2

Le fragment de code suivant montre comment spécifier un paramètre datetime2 avec les parties date et heure.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@Datetime2";
parameter.SqlDbType = SqlDbType.DateTime2;
parameter.Value = DateTime.Parse("1666-09-02 1:00:00");

Dim parameter As New SqlParameter()
parameter.ParameterName = "@Datetime2"
parameter.SqlDbType = SqlDbType.DateTime2
parameter.Value = DateTime.Parse("1666-09-02 1:00:00")

Exemple relatif au paramètre DateTimeOffset

Le fragment de code suivant montre comment spécifier un paramètre DateTimeOffset avec une date, une heure et un décalage de fuseau horaire égal à 0.

SqlParameter parameter = new SqlParameter();
parameter.ParameterName = "@DateTimeOffSet";
parameter.SqlDbType = SqlDbType.DateTimeOffset;
parameter.Value = DateTimeOffset.Parse("1666-09-02T01:00:00+00:00");

Dim parameter As New SqlParameter()
parameter.ParameterName = "@DateTimeOffSet"
parameter.SqlDbType = SqlDbType.DateTimeOffset
parameter.Value = DateTimeOffset.Parse("1666-09-02T01:00:00+00:00")

AddWithValue

Pour fournir des paramètres, vous pouvez également appeler AddWithValue sur la collection Parameters de la commande, comme indiqué dans le fragment de code suivant. Toutefois, AddWithValue ne vous permet pas de spécifier le DbType ou le SqlDbType pour le paramètre.

command.Parameters.AddWithValue(
    "@date", DateTimeOffset.Parse("1666-09-02T01:00:00+00:00"));

command.Parameters.AddWithValue( _
    "@date", DateTimeOffset.Parse("1666-09-02T01:00:00+00:00"))

Pour cette DateTimeOffset valeur, AddWithValue déduit SqlDbType.DateTimeOffset. Pour cibler un autre type de date ou d'heure SQL Server, définissez explicitement la propriété du SqlDbType paramètre.

Le tableau suivant indique quels SqlDbTypes sont déduits de quels types CLR :

Récupération des données de date et d'heure

Le tableau suivant décrit les méthodes utilisées pour récupérer des valeurs de date et d’heure SQL Server 2008.

Spécification des valeurs de date et d'heure en tant que littéraux

Vous pouvez spécifier des types de données de date et d’heure à l’aide de différents formats de chaîne littérale, que SQL Server évalue ensuite au moment de l’exécution, en les convertissant en structures de date/heure internes. SQL Server reconnaît les données de date et heure placées entre guillemets simples ('). Les exemples ci-dessous illustrent certains formats :

• Formats de date alphabétiques, tels que 'October 15, 2006'.

• Formats de date numériques, tels que '10/15/2006'.

• Les formats de chaîne non séparés, par exemple '20061015', qui serait interprété comme le 15 octobre 2006 si vous utilisiez le format de date standard ISO.

Les valeurs temporelles inférieures à zéro ou supérieures ou égales à 24 heures provoqueront une ArgumentException.

Ressources de documentation SQL Server

Pour plus d’informations sur l’utilisation des valeurs de date et d’heure dans SQL Server, consultez les articles suivants.

Voir aussi

• Mappages de types de données SQL Server
• Configuration des paramètres et des types de données des paramètres
• Types de données SQL Server et ADO.NET
• Vue d'ensemble d’ADO.NET