Partager via


Fonctions de date et d'heure canoniques

Entity SQL comprend des fonctions canoniques de date et d’heure.

Notes

Le tableau suivant présente les fonctions canoniques Entity SQL de date et d’heure. datetime est une valeur DateTime.

Fonction Description
AddNanoseconds(expression,number) Ajoute le nombre number spécifié de nanosecondes à l'expression.

Arguments

expression : DateTime, DateTimeOffset ou Time.

number: Int32.

Valeur de retour

Type d'élément expression.
AddMicroseconds(expression,number) Ajoute le nombre number spécifié de microsecondes à l'expression.

Arguments

expression : DateTime, DateTimeOffset ou Time.

number: Int32.

Valeur de retour

Type d'élément expression.
AddMilliseconds(expression,number) Ajoute le nombre number spécifié de millisecondes à l'expression.

Arguments

expression : DateTime, DateTimeOffset ou Time.

number: Int32.

Valeur de retour

Type d'élément expression.
AddSeconds(expression,number) Ajoute le nombre number spécifié de secondes à l'expression.

Arguments

expression : DateTime, DateTimeOffset ou Time.

number: Int32.

Valeur de retour

Type d'élément expression.
AddMinutes(expression,number) Ajoute le nombre number spécifié de minutes à l'expression.

Arguments

expression : DateTime, DateTimeOffset ou Time.

number: Int32.

Valeur de retour

Type d'élément expression.
AddHours(expression,number) Ajoute le nombre number spécifié d'heures à l'expression.

Arguments

expression : DateTime, DateTimeOffset ou Time.

number: Int32.

Valeur de retour

Type d'élément expression.
AddDays(expression,number) Ajoute le nombre number spécifié de jours à l'expression.

Arguments

expression : DateTime ou DateTimeOffset.

number: Int32.

Valeur de retour

Type d'élément expression.
AddMonths(expression,number) Ajoute le nombre number spécifié de mois à l'expression.

Arguments

expression : DateTime ou DateTimeOffset.

number: Int32.

Valeur de retour

Type d'élément expression.
AddYears(expression,number) Ajoute le nombre number spécifié d'années à l'expression.

Arguments

expression : DateTime ou DateTimeOffset.

number: Int32.

Valeur de retour

Type d'élément expression.
CreateDateTime(year,month,day,hour,minute,second) Retourne une nouvelle valeur DateTime correspondant aux date et heure actuelles du serveur dans le fuseau horaire du serveur.

Arguments

year, month, day, hour, minute : Int16 et Int32.

second: Double.

Valeur de retour

Un DateTime.
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) Retourne une nouvelle valeur DateTimeOffset correspondant aux date et heure actuelles du serveur par rapport au temps universel (UTC, Universal Time Coordinated).

Arguments

year, month, day, hour, minute, tzoffset: Int32.

second: Double.

Valeur de retour

Un DateTimeOffset.
CreateTime(hour,minute,second) Retourne une nouvelle valeur Time correspondant à l'heure actuelle.

Arguments

hour et minute : Int32.

second: Double.

Valeur de retour

Un Time.
CurrentDateTime() Retourne une valeur DateTime correspondant aux date et heure actuelles du serveur dans le fuseau horaire de ce dernier.

Valeur de retour

Un DateTime.
CurrentDateTimeOffset() Retourne la date, l'heure et le décalage actuels sous forme de valeur DateTimeOffset.

Valeur de retour

Un DateTimeOffset.
CurrentUtcDateTime() Renvoie une valeur DateTime correspondant aux date et heure actuelles du serveur dans le fuseau horaire UTC.

Valeur de retour

Un DateTime.
Day(expression) Retourne la composante jour d'expression sous forme d'une valeur Int32 comprise entre 1 et 31.

Arguments

DateTime et DateTimeOffset.

Valeur de retour

Élément Int32.

Exemple

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
DayOfYear(expression) Retourne la composante jour d'expression sous la forme d'une valeur Int32 comprise entre 1 et 366, où 366 correspond au dernier jour d'une année bissextile.

Arguments

DateTime ou DateTimeOffset.

Valeur de retour

Élément Int32.
DiffNanoseconds(startExpression,endExpression) Retourne la différence, en nanosecondes, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime, DateTimeOffset ou Time. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffMilliseconds(startExpression,endExpression) Retourne la différence, en millisecondes, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime, DateTimeOffset ou Time. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffMicroseconds(startExpression,endExpression) Retourne la différence, en microsecondes, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime, DateTimeOffset ou Time. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffSeconds(startExpression,endExpression) Retourne la différence, en secondes, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime, DateTimeOffset ou Time. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffMinutes(startExpression,endExpression) Retourne la différence, en minutes, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime, DateTimeOffset ou Time. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffHours(startExpression,endExpression) Retourne la différence, en heures, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime, DateTimeOffset ou Time. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffDays(startExpression,endExpression) Retourne la différence, en jours, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime ou DateTimeOffset. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffMonths(startExpression,endExpression) Retourne la différence, en mois, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime ou DateTimeOffset. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
DiffYears(startExpression,endExpression) Retourne la différence, en années, entre startExpression et endExpression.

Arguments

startExpression, endExpression : DateTime ou DateTimeOffset. Remarque : startExpression et endExpression doivent être du même type.

Valeur de retour

Élément Int32.
GetTotalOffsetMinutes(datetimeoffset) Retourne le nombre de minutes correspondant au décalage de datetimeoffset par rapport à l'heure GMT. Cette valeur est généralement comprise entre +780 et -780 (+ ou - 13 heures). Remarque : cette fonction n’est prise en charge que dans SQL Server 2008.

Arguments

Un DateTimeOffset.

Valeur de retour

Élément Int32.
Hour(expression) Retourne la composante heure d'expression sous la forme d'une valeur Int32 comprise entre 0 et 23.

Arguments

DateTime, Time et DateTimeOffset.

Exemple

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond(expression) Retourne la composante millisecondes d'expression sous la forme d'une valeur Int32 comprise entre 0 et 999.

Arguments

DateTime, Time et DateTimeOffset.

Valeur de retour

Élément Int32.
Minute(expression) Retourne la composante minutes d'expression sous la forme d'une valeur Int32 comprise entre 0 et 59.

Arguments

DateTime, Time ou DateTimeOffset.

Valeur de retour

Élément Int32.

Exemple

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month(expression) Retourne la composante mois d'expression sous la forme d'une valeur Int32 comprise entre 1 et 12.

Arguments

DateTime ou DateTimeOffset.

Valeur de retour

Élément Int32.

Exemple

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second(expression) Retourne la composante secondes d'expression sous forme de valeur Int32 comprise entre 0 et 59.

Arguments

DateTime, Time et DateTimeOffset.

Valeur de retour

Élément Int32.

Exemple

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) Retourne l'expression avec les valeurs d'heure tronquées.

Arguments

DateTime ou DateTimeOffset.

Valeur de retour

Type d'élément expression.
Year(expression) Renvoie la composante année de expression sous la forme d’une valeur Int32 YYYY.

Arguments

DateTime et DateTimeOffset.

Valeur de retour

Élément Int32.

Exemple

-- The following example returns 1998.

Year(cast('03/12/1998' as DateTime))

Ces fonctions retournent null si une entrée de valeur null est fournie.

Des fonctionnalités équivalentes sont disponibles dans le fournisseur managé Client Microsoft SQL. Pour plus d’informations, consultez Fonctions SqlClient pour l’Entity Framework.

Voir aussi