Fonctions de date et heure
Le fournisseur de données .NET Framework pour SQL Server (SqlClient) propose des fonctions de date et d'heure qui effectuent des opérations sur une valeur d'entrée System.DateTime et retournent une valeur string, numérique ou System.DateTime comme résultat. Ces fonctions se trouvent dans l'espace de noms SqlServer, lequel est disponible lorsque vous utilisez SqlClient. La propriété d’espace de noms d’un fournisseur permet à Entity Framework de découvrir le préfixe attribué par ce fournisseur à des constructions spécifiques, telles que des types et des fonctions. Le tableau suivant présente les fonctions de date et heure de SqlClient.
| Fonction | Description |
|---|---|
DATEADD(datepart, number, date) |
Retourne une nouvelle valeur DateTime basée sur l'ajout d'un intervalle à la date spécifiée.Arguments datepart : chaîne String qui représente la partie de la date sur laquelle retourner une nouvelle valeur.number : valeur Int32, Int64, Decimal ou Double utilisée pour incrémenter datepart.date: Expression qui retourne une valeur DateTime, DateTimeOffset ou Time avec une précision comprise entre 0-7, ou une chaîne de caractères dans un format de date.Valeur de retour Une nouvelle valeur DateTime, DateTimeOffset ou Time avec une précision comprise entre 0-7.Exemple SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime)) |
DATEDIFF(datepart,startdate,enddate) |
Renvoie le nombre de limites de date et d'heure traversées entre deux dates données. Arguments datepart : chaîne String qui représente la partie de la date sur laquelle doit être calculée la différence.startdate : une date de début pour le calcul est une expression qui retourne une valeur DateTime, DateTimeOffset ou Time avec une précision comprise entre 0 et 7, ou une chaîne de caractères dans un format de date.enddate: Une date de fin pour le calcul est une expression qui retourne une valeur DateTime, DateTimeOffset ou Time avec une précision comprise entre 0 et 7, ou une chaîne de caractères dans un format de date.Valeur de retour Élément Int32.Exemple SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),cast('6/20/2006' as DateTime)) |
DATENAME(datepart, date) |
Retourne une chaîne de caractères représentant la composante date spécifiée de la date spécifiée. Arguments datepart : chaîne String qui représente la partie de la date sur laquelle retourner une nouvelle valeur.date : expression qui retourne une valeur DateTime,DateTimeOffset ou Time avec une précision comprise entre 0 et 7, ou une chaîne de caractères dans un format de date.Valeur de retour Chaîne de caractères représentant la partie de date spécifiée de la date donnée. Exemple SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
Retourne un entier qui représente l'élément de date spécifié de la date donnée. Arguments datepart : chaîne String qui représente la partie de la date sur laquelle retourner une nouvelle valeur.date : expression qui retourne une valeur DateTime,DateTimeOffset, ou Time avec une précision comprise entre 0 et 7, ou une chaîne de caractères dans un format de date.Valeur de retour Partie de date spécifiée de la date donnée, sous la forme d'une valeur Int32.Exemple SqlServer.DATEPART('year', cast('6/9/2006' as DateTime)) |
DAY(date) |
Retourne le jour de la date spécifiée sous la forme d’un entier. Arguments date : Expression de type DateTime ou DateTimeOffset avec une précision comprise entre 0-7.Valeur de retour Jour de la date spécifiée, sous la forme d'une valeur Int32.Exemple SqlServer.DAY(cast('6/9/2006' as DateTime)) |
GETDATE() |
Fournit la date et l'heure actuelles sous la forme employée de manière interne par SQL Server pour stocker les valeurs datetime. Valeur de retour Date et heure système actuelles sous forme de valeur DateTime avec une précision de 3.Exemple SqlServer.GETDATE() |
GETUTCDATE() |
Produit la valeur datetime au format UTC (Universal Time Coordinate ou GMT (heure de Greenwich)). Valeur de retour Valeur DateTime avec une précision de 3 au format UTC.Exemple SqlServer.GETUTCDATE() |
MONTH(date) |
Retourne la partie mois de la date spécifiée sous la forme d'un entier. Arguments date : Expression de type DateTime ou DateTimeOffset avec une précision comprise entre 0-7.Valeur de retour Partie mois de la date spécifiée sous la forme d'une valeur Int32.Exemple SqlServer.MONTH(cast('6/9/2006' as DateTime)) |
YEAR(date) |
Retourne l'année de la date spécifiée sous la forme d'un entier. Arguments date : Expression de type DateTime ou DateTimeOffset avec une précision comprise entre 0-7.Valeur de retour Année de la date spécifiée, sous la forme d'une valeur Int32.Exemple SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
Retourne une valeur DateTime avec une précision de 7.Valeur de retour Valeur DateTime avec une précision de 7.Exemple SqlServer.SYSDATETIME() |
SYSUTCDATE() |
Produit la valeur datetime au format UTC (Universal Time Coordinate ou GMT (heure de Greenwich)). Valeur de retour Valeur DateTime avec une précision de 7 au format UTC.Exemple SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
Retourne une valeur DateTimeOffset avec une précision de 7.Valeur de retour Valeur DateTimeOffset avec une précision de 7 au format UTC.Exemple SqlServer.SYSDATETIMEOFFSET() |
Pour plus d’informations sur les fonctions de date et d’heure que SqlClient prend en charge, consultez Types de données et fonctions de date et d’heure (Transact-SQL).