Partager via


Fonctions de date et d’heure

Le fournisseur de données .NET Framework pour SQL Server (SqlClient) fournit des fonctions de date et d’heure qui effectuent des opérations sur une System.DateTime valeur d’entrée et retournent un stringrésultat, numérique ou System.DateTime valeur. Ces fonctions se trouvent dans l’espace de noms SqlServer, qui 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 utilisé par ce fournisseur pour des constructions spécifiques, telles que des types et des fonctions. Le tableau suivant montre les fonctions de date et d’heure SqlClient.

Fonction Descriptif
DATEADD(datepart, number, date) Retourne une nouvelle valeur DateTime basée sur l'ajout d'un intervalle à la date spécifiée.

Arguments

datepart: Un String qui représente la partie de la date pour laquelle une nouvelle valeur sera retournée.

number: La valeur Int32, Int64, Decimal, ou Double utilisée pour incrémenter datepart.

date: Expression qui retourne un DateTime, ou DateTimeOffset, ou Time avec précision égale à [0-7], ou une chaîne de caractères dans un format de date.

valeur de retour

Nouvelle valeur DateTime, DateTimeOffset ou Time avec une précision égale à [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 un DateTime, ou DateTimeOffset, ou Time une valeur avec précision = [0-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 DateTime, ou une DateTimeOffset, ou une Time valeur avec précision = [0-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: Un String qui représente la partie de la date pour laquelle une nouvelle valeur sera retournée.

date: expression qui renvoie une DateTime, ou DateTimeOffset, ou Time une valeur avec précision = [0-7], ou une chaîne de caractères dans un format de date.

valeur de retour

Chaîne de caractères représentant le composant de date spécifié de la date donnée.

Exemple

SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART(datepart, date) Retourne un entier qui représente la partie spécifiée de la date indiquée.

Arguments

datepart: Un String qui représente la partie de la date pour laquelle une nouvelle valeur sera retournée.

date: expression qui renvoie une DateTime, ou DateTimeOffset,Time une valeur avec précision = [0-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 forme d’entier.

Arguments

date:Expression de type DateTime ou DateTimeOffset avec précision = 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 la forme DateTime d’une précision de 3.

Exemple

SqlServer.GETDATE()
GETUTCDATE() Produit la valeur datetime au format UTC (Temps universel coordonné ou Heure moyenne de Greenwich).

valeur de retour

Valeur DateTime avec une précision de 3 au format UTC.

Exemple

SqlServer.GETUTCDATE()
MONTH(date) Retourne le mois de la date spécifiée sous forme d’entier.

Arguments

date:Expression de type DateTime ou DateTimeOffset avec précision = 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 forme d’entier.

Arguments

date:Expression de type DateTime ou DateTimeOffset avec précision = 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 DateTime valeur 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 (Temps universel coordonné ou Heure moyenne 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 et fonctions de données de date et d’heure (Transact-SQL).

Voir aussi