Fonctions canoniques de date et d'heure (Entity SQL)
Entity SQL comprend des fonctions canoniques de date et d'heure.
Notes
Le tableau suivant répertorie 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'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'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'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'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'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'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'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'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'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 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 DateTimeOffset. |
CreateTime( hour, minute, second) |
Retourne une nouvelle valeur Time correspondant à l'heure actuelle. Arguments hour et minute : Int32. second: Double. Valeur de retour Time. |
CurrentDateTime() |
Retourne une valeur DateTime correspondant aux date et heure actuelles du serveur dans le fuseau horaire de ce dernier. Valeur de retour DateTime. |
CurrentDateTimeOffset() |
Retourne la date, l'heure et le décalage actuels sous forme de valeur DateTimeOffset. Valeur de retour DateTimeOffset. |
CurrentUtcDateTime() |
Retourne une valeur DateTime correspondant aux date et heure actuelles du serveur dans le fuseau horaire UTS. Valeur de retour 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 Int32. Exemple
|
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 Int32. |
DiffNanoseconds( startExpression, endExpression) |
Retourne la différence, en nanosecondes, entre startExpression et endExpression. Arguments startExpression, endExpression : DateTime, DateTimeOffset ou Time. .gif "Bb738563.note(fr-fr,VS.100).gif") Remarque :
startExpression et endExpression doivent être du même type.
Valeur de retour 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 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 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 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 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 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 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 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 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 DateTimeOffset. Valeur de retour 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
|
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 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 Objet Int32. Exemple
|
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 Int32. Exemple
|
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 Objet Int32. Exemple
|
Truncate( expression ) |
Retourne l'expression avec les valeurs d'heure tronquées. Arguments DateTime ou DateTimeOffset. Valeur de retour Type d'expression. |
Year( expression ) |
Retourne la composante année d'expression sous la forme d'une valeur Int32 YYYY. Arguments DateTime et DateTimeOffset. Valeur de retour Int32. Exemple
|
Ces fonctions retournent la valeur Null si une valeur Null leur est fournie en entrée.
Des fonctionnalités équivalentes sont disponibles dans le fournisseur managé Client Microsoft SQL. Pour plus d'informations, voir Fournisseur de données .NET Framework pour SQL Server (SqlClient) pour les fonctions Entity Framework.