Condividi tramite


Funzioni data e ora canoniche

Entity SQL include funzioni canoniche di data e ora.

Osservazioni:

Nella tabella seguente sono illustrate le funzioni canoniche Entity SQL di data e ora. datetime è un valore DateTime.

Funzione Descrizione
AddNanoseconds(expression,number) Aggiunge i nanosecondi specificati dal valore di number all'oggetto expression.

Argomenti

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valore restituito

Tipo di expression.
AddMicroseconds(expression,number) Aggiunge il number specificato di microsecondi all'oggetto expression.

Argomenti

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valore restituito

Tipo di expression.
AddMilliseconds(expression,number) Aggiunge il number specificato di millisecondi all'oggetto expression.

Argomenti

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valore restituito

Tipo di expression.
AddSeconds(expression,number) Aggiunge il number specificato di secondi all'oggetto expression.

Argomenti

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valore restituito

Tipo di expression.
AddMinutes(expression,number) Aggiunge il number specificato di minuti all'oggetto expression.

Argomenti

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valore restituito

Tipo di expression.
AddHours(expression,number) Aggiunge il number specificato di ore all'oggetto expression.

Argomenti

expression: DateTime, DateTimeOffset o Time.

number: Int32.

Valore restituito

Tipo di expression.
AddDays(expression,number) Aggiunge il number specificato di giorni all'oggetto expression.

Argomenti

expression: DateTime o DateTimeOffset.

number: Int32.

Valore restituito

Tipo di expression.
AddMonths(expression,number) Aggiunge il number specificato di mesi all'oggetto expression.

Argomenti

expression: DateTime o DateTimeOffset.

number: Int32.

Valore restituito

Tipo di expression.
AddYears(expression,number) Aggiunge il number specificato di anni all'oggetto expression.

Argomenti

expression: DateTime o DateTimeOffset.

number: Int32.

Valore restituito

Tipo di expression.
CreateDateTime(year,month,day,hour,minute,second) Restituisce un nuovo valore DateTime come data e ora correnti del server nel fuso orario del server.

Argomenti

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

second: Double.

Valore restituito

Un oggetto DateTime.
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.

Argomenti

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

second: Double.

Valore restituito

Un oggetto DateTimeOffset.
CreateTime(hour,minute,second) Restituisce un nuovo valore Time come ora corrente.

Argomenti

hour e minute: Int32.

second: Double.

Valore restituito

Un oggetto Time.
CurrentDateTime() Restituisce un valore DateTime come data e ora correnti del server nel fuso orario del server.

Valore restituito

Un oggetto DateTime.
CurrentDateTimeOffset() Restituisce la data, l'ora e l'offset correnti come DateTimeOffset.

Valore restituito

Un oggetto DateTimeOffset.
CurrentUtcDateTime() Restituisce un valore DateTime come data e ora correnti del server nel fuso orario UTC.

Valore restituito

Un oggetto DateTime.
Day(expression) Restituisce la parte relativa al giorno di expression come tipo Int32 compreso tra 1 e 31.

Argomenti

Tipi DateTime e DateTimeOffset.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
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.

Argomenti

Tipo DateTime o DateTimeOffset.

Valore restituito

Oggetto Int32.
DiffNanoseconds(startExpression,endExpression) Restituisce la differenza in nanosecondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffMilliseconds(startExpression,endExpression) Restituisce la differenza in millisecondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffMicroseconds(startExpression,endExpression) Restituisce la differenza in microsecondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffSeconds(startExpression,endExpression) Restituisce la differenza in secondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffMinutes(startExpression,endExpression) Restituisce la differenza in minuti tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffHours(startExpression,endExpression) Restituisce la differenza in ore tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffDays(startExpression,endExpression) Restituisce la differenza in giorni tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime o DateTimeOffset. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffMonths(startExpression,endExpression) Restituisce la differenza in mesi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime o DateTimeOffset. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
DiffYears(startExpression,endExpression) Restituisce la differenza in anni tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime o DateTimeOffset. Nota: startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Oggetto Int32.
GetTotalOffsetMinutes(datetimeoffset) Restituisce il numero di minuti di offset di datetimeoffset rispetto al fuso orario GMT. Generalmente si tratta di un valore compreso tra +780 e -780 (+ o - 13 ore). Note: questa funzione è supportata solo in SQL Server 2008.

Argomenti

Un oggetto DateTimeOffset.

Valore restituito

Oggetto Int32.
Hour(expression) Restituisce la parte relativa all'ora di expression come tipo Int32 compreso tra 0 e 23.

Argomenti

Tipi DateTime, Time e DateTimeOffset.

Esempio

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond(expression) Restituisce la parte relativa ai millisecondi di expression come tipo Int32 compreso tra 0 e 999.

Argomenti

Tipi DateTime, Time e DateTimeOffset.

Valore restituito

Oggetto Int32.
Minute(expression) Restituisce la parte relativa ai minuti di expression come tipo Int32 compreso tra 0 e 59.

Argomenti

Tipo DateTime, Time o DateTimeOffset.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month(expression) Restituisce la parte relativa al mese di expression come tipo Int32 compreso tra 1 e 12.

Argomenti

Tipo DateTime o DateTimeOffset.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second(expression) Restituisce la parte relativa ai secondi di expression come tipo Int32 compreso tra 0 e 59.

Argomenti

Tipi DateTime, Time e DateTimeOffset.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) Restituisce expression, con i valori dell'ora troncati.

Argomenti

Tipo DateTime o DateTimeOffset.

Valore restituito

Tipo di expression.
Year(expression) Restituisce la parte relativa all'anno di expression come Int32 YYYY.

Argomenti

Tipi DateTime e DateTimeOffset.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 1998.

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

Queste funzioni restituiscono null se l'input è null.

Una funzionalità equivalente è disponibile nel provider gestito del client Microsoft SQL. Per altre informazioni, vedere SqlClient per funzioni di Entity Framework.

Vedi anche