Funzioni data e ora canonicheDate and Time Canonical Functions

Entity SQLEntity SQL include funzioni canoniche di data e ora. includes date and time canonical functions.

NoteRemarks

Nella tabella seguente mostra la data e ora Entity SQLEntity SQL funzioni canoniche.The following table shows the date and time Entity SQLEntity SQL canonical functions. datetime è un DateTime valore.datetime is a DateTime value.

FunzioneFunction DescrizioneDescription
AddNanoseconds( expression, number``)AddNanoseconds( expression, number``) Aggiunge i nanosecondi specificati dal valore di number all'oggetto expression.Adds the specified number of nanoseconds to the expression.

ArgomentiArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddMicroseconds( expression, number``)AddMicroseconds( expression, number``) Aggiunge il number specificato di microsecondi all'oggetto expression.Adds the specified number of microseconds to the expression.

ArgomentiArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddMilliseconds( expression, number``)AddMilliseconds( expression, number``) Aggiunge il number specificato di millisecondi all'oggetto expression.Adds the specified number of milliseconds to the expression.

ArgomentiArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddSeconds( expression, number``)AddSeconds( expression, number``) Aggiunge il number specificato di secondi all'oggetto expression.Adds the specified number of seconds to the expression.

ArgomentiArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddMinutes( expression, number``)AddMinutes( expression, number``) Aggiunge il number specificato di minuti all'oggetto expression.Adds the specified number of minutes to the expression.

ArgomentiArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddHours( expression, number``)AddHours( expression, number``) Aggiunge il number specificato di ore all'oggetto expression.Adds the specified number of hours to the expression.

ArgomentiArguments

expression: DateTime, DateTimeOffset o Time.expression: DateTime, DateTimeOffset, or Time.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddDays( expression, number``)AddDays( expression, number``) Aggiunge il number specificato di giorni all'oggetto expression.Adds the specified number of days to the expression.

ArgomentiArguments

expression: DateTime o DateTimeOffset.expression: DateTime or DateTimeOffset.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddMonths( expression, number``)AddMonths( expression, number``) Aggiunge il number specificato di mesi all'oggetto expression.Adds the specified number of months to the expression.

ArgomentiArguments

expression: DateTime o DateTimeOffset.expression: DateTime or DateTimeOffset.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
AddYears( expression, number``)AddYears( expression, number``) Aggiunge il number specificato di anni all'oggetto expression.Adds the specified number of years to the expression.

ArgomentiArguments

expression: DateTime o DateTimeOffset.expression: DateTime or DateTimeOffset.

number: Int32.number: Int32.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
CreateDateTime( year, month, day, hour, minute, second``)CreateDateTime( year, month, day, hour, minute, second``) Restituisce un nuovo valore DateTime come data e ora correnti del server nel fuso orario del server.Returns a new DateTime value as the current date and time of the server in the server's time zone.

ArgomentiArguments

year, month, day, hour, minute: Int16 e Int32.year, month, day, hour, minute: Int16 and Int32.

second: Double.second: Double.

Valore restituitoReturn Value

Oggetto DateTime.A DateTime.
CreateDateTimeOffset( year, month, day, hour, minute, second, tzoffset``)CreateDateTimeOffset( year, month, day, hour, minute, second, tzoffset``) Restituisce un nuovo valore DateTimeOffset come data e ora correnti del server rispetto al fuso orario UTC.Returns a new DateTimeOffset value as the current date and time of the server relative to the Coordinated Universal Time (UTC).

ArgomentiArguments

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

second: Double.second: Double.

Valore restituitoReturn Value

Oggetto DateTimeOffset.A DateTimeOffset.
CreateTime( hour, minute, second``)CreateTime( hour, minute, second``) Restituisce un nuovo valore Time come ora corrente.Returns a new Time value as the current time.

ArgomentiArguments

hour e minute: Int32.hour and minute: Int32.

second: Double.second: Double.

Valore restituitoReturn Value

Oggetto Time.A Time.
CurrentDateTime() Restituisce un valore DateTime come data e ora correnti del server nel fuso orario del server.Returns a DateTime value as the current date and time of the server in the server's time zone.

Valore restituitoReturn Value

Oggetto DateTime.A DateTime.
CurrentDateTimeOffset() Restituisce la data, l'ora e l'offset correnti come DateTimeOffset.Returns the current date, time and offset as a DateTimeOffset.

Valore restituitoReturn Value

Oggetto DateTimeOffset.A DateTimeOffset.
CurrentUtcDateTime() Restituisce un valore DateTime come data e ora correnti del server nel fuso orario UTS.Returns a DateTime value as the current date and time of the server in the UTS time zone.

Valore restituitoReturn Value

Oggetto DateTime.A DateTime.
Day( expression )Day( expression ) Restituisce la parte relativa al giorno di expression come tipo Int32 compreso tra 1 e 31.Returns the day portion of expression as an Int32 between 1 and 31.

ArgomentiArguments

Tipi DateTime e DateTimeOffset.A DateTime and DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.

EsempioExample

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
DayOfYear( expression )DayOfYear( expression ) Restituisce la parte relativa al giorno di expression come Int32 compreso tra 1 e 366, dove 366 viene restituito come l'ultimo giorno di un anno bisestile.Returns the day portion of expression as an Int32 between 1 and 366, where 366 is returned for the last day of a leap year.

ArgomentiArguments

Tipo DateTime o DateTimeOffset.A DateTime or DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffNanoseconds( startExpression, endExpression``)DiffNanoseconds( startExpression, endExpression``) Restituisce la differenza in nanosecondi tra startExpression e endExpression.Returns the difference, in nanoseconds, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffMilliseconds( startExpression, endExpression``)DiffMilliseconds( startExpression, endExpression``) Restituisce la differenza in millisecondi tra startExpression e endExpression.Returns the difference, in milliseconds, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffMicroseconds( startExpression, endExpression``)DiffMicroseconds( startExpression, endExpression``) Restituisce la differenza in microsecondi tra startExpression e endExpression.Returns the difference, in microseconds, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffSeconds( startExpression, endExpression``)DiffSeconds( startExpression, endExpression``) Restituisce la differenza in secondi tra startExpression e endExpression.Returns the difference, in seconds, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffMinutes( startExpression, endExpression``)DiffMinutes( startExpression, endExpression``) Restituisce la differenza in minuti tra startExpression e endExpression.Returns the difference, in minutes, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffHours( startExpression, endExpression``)DiffHours( startExpression, endExpression``) Restituisce la differenza in ore tra startExpression e endExpression.Returns the difference, in hours, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime, DateTimeOffset o Time.startExpression, endExpression: DateTime, DateTimeOffset, or Time. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffDays( startExpression, endExpression``)DiffDays( startExpression, endExpression``) Restituisce la differenza in giorni tra startExpression e endExpression.Returns the difference, in days, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime o DateTimeOffset.startExpression, endExpression: DateTime or DateTimeOffset. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffMonths( startExpression, endExpression``)DiffMonths( startExpression, endExpression``) Restituisce la differenza in mesi tra startExpression e endExpression.Returns the difference, in months, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime o DateTimeOffset.startExpression, endExpression: DateTime or DateTimeOffset. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
DiffYears( startExpression, endExpression``)DiffYears( startExpression, endExpression``) Restituisce la differenza in anni tra startExpression e endExpression.Returns the difference, in years, between startExpression and endExpression.

ArgomentiArguments

startExpression, endExpression: DateTime o DateTimeOffset.startExpression, endExpression: DateTime or DateTimeOffset. Nota: startExpression e endExpression deve essere dello stesso tipo. Note: startExpression and endExpression must be of the same type.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
GetTotalOffsetMinutes( datetimeoffset )GetTotalOffsetMinutes( datetimeoffset ) Restituisce il numero di minuti di offset di datetimeoffset rispetto al fuso orario GMT.Returns the number of minutes that the datetimeoffset is offset from GMT. Generalmente si tratta di un valore compreso tra +780 e -780 (+ o - 13 ore).This is generally between +780 and -780 (+ or - 13 hrs). Nota: questa funzione è supportata solo in SQL Server 2008.Note: This function is supported in SQL Server 2008 only.

ArgomentiArguments

Oggetto DateTimeOffset.A DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
Hour ( expression )Hour ( expression ) Restituisce la parte relativa all'ora di expression come tipo Int32 compreso tra 0 e 23.Returns the hour portion of expression as an Int32 between 0 and 23.

ArgomentiArguments

Tipi DateTime, Time e DateTimeOffset.A DateTime, Time and DateTimeOffset.

EsempioExample

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond( expression )Millisecond( expression ) Restituisce la parte relativa ai millisecondi di expression come tipo Int32 compreso tra 0 e 999.Returns the milliseconds portion of expression as an Int32 between 0 and 999.

ArgomentiArguments

Tipi DateTime, Time e DateTimeOffset.A DateTime, Time and DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.
Minute( expression )Minute( expression ) Restituisce la parte relativa ai minuti di expression come tipo Int32 compreso tra 0 e 59.Returns the minute portion of expression as an Int32 between 0 and 59.

ArgomentiArguments

Tipo DateTime, Time o DateTimeOffset.A DateTime, Time or DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.

EsempioExample

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month ( expression )Month ( expression ) Restituisce la parte relativa al mese di expression come tipo Int32 compreso tra 1 e 12.Returns the month portion of expression as an Int32 between 1 and 12.

ArgomentiArguments

Tipo DateTime o DateTimeOffset.A DateTime or DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.

EsempioExample

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second( expression )Second( expression ) Restituisce la parte relativa ai secondi di expression come tipo Int32 compreso tra 0 e 59.Returns the seconds portion of expression as an Int32 between 0 and 59.

ArgomentiArguments

Tipi DateTime, Time e DateTimeOffset.A DateTime, Time and DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.

EsempioExample

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime( expression )TruncateTime( expression ) Restituisce expression, con i valori dell'ora troncati.Returns the expression, with the time values truncated.

ArgomentiArguments

Tipo DateTime o DateTimeOffset.A DateTime or DateTimeOffset.

Valore restituitoReturn Value

Tipo di expression.The type of expression.
Year( expression )Year( expression ) Restituisce la parte relativa all'anno di expression come un Int32``YYYY.Returns the year portion of expression as an Int32``YYYY.

ArgomentiArguments

Tipi DateTime e DateTimeOffset.A DateTime and DateTimeOffset.

Valore restituitoReturn Value

Oggetto Int32.An Int32.

EsempioExample

-- The following example returns 1998.

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

Queste funzioni restituiscono null se l'input è null.These functions will return null if given null input.

Una funzionalità equivalente è disponibile nel provider gestito del client Microsoft SQL.Equivalent functionality is available in the Microsoft SQL Client Managed Provider. Per ulteriori informazioni, vedere SqlClient per funzioni Entity Framework.For more information, see SqlClient for Entity Framework Functions.

Vedere ancheSee Also

Funzioni canonicheCanonical Functions