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 Int32YYYY. 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

• Fonctions canoniques