Condividi tramite

Funzioni canoniche di data e ora (Entity SQL)

  • Articolo

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 il number specificato di nanosecondi 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

Tipo 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

Tipo DateTimeOffset.

CreateTime( hour, minute, second)

Restituisce un nuovo valore Time come ora corrente.

Argomenti

hour e minute: Int32.

second: Double.

Valore restituito

Tipo Time.

CurrentDateTime()

Restituisce un valore DateTime come data e ora correnti del server nel fuso orario del server.

Valore restituito

Tipo DateTime.

CurrentDateTimeOffset()

Restituisce la data, l'ora e l'offset correnti come DateTimeOffset.

Valore restituito

Tipo DateTimeOffset.

CurrentUtcDateTime()

Restituisce un valore DateTime come data e ora correnti del server nel fuso orario UTS.

Valore restituito

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

Tipo 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

Tipo Int32.

DiffNanoseconds( startExpression, endExpression)

Restituisce la differenza in nanosecondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffMilliseconds( startExpression, endExpression)

Restituisce la differenza in millisecondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffMicroseconds( startExpression, endExpression)

Restituisce la differenza in microsecondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffSeconds( startExpression, endExpression)

Restituisce la differenza in secondi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffMinutes( startExpression, endExpression)

Restituisce la differenza in minuti tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffHours( startExpression, endExpression)

Restituisce la differenza in ore tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime, DateTimeOffset o Time.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffDays( startExpression, endExpression)

Restituisce la differenza in giorni tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime o DateTimeOffset.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffMonths( startExpression, endExpression)

Restituisce la differenza in mesi tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime o DateTimeOffset.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

DiffYears( startExpression, endExpression)

Restituisce la differenza in anni tra startExpression e endExpression.

Argomenti

startExpression, endExpression: DateTime o DateTimeOffset.

Bb738563.note(it-it,VS.100).gifNota:
startExpression e endExpression devono essere dello stesso tipo.

Valore restituito

Tipo Int32.

GetTotalOffsetMinutes( datetimeoffset )

Restituisce il numero di minuti di offset di datetimeoffset rispetto al fuso orario GMT. In genere si tratta di un valore compreso tra +780 e -780 (+ o - 13 ore).

Bb738563.note(it-it,VS.100).gifNota:
Questa funzione è supportata solo in SQL Server 2008.

Argomenti

Tipo DateTimeOffset.

Valore restituito

Tipo Int32.

Hour ( expression )

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

Arguments

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

DateTime, Time e DateTimeOffset.

Valore restituito

Tipo 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

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

Arguments

Tipo DateTime o DateTimeOffset.

Valore restituito

Tipo 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

DateTime, Time e DateTimeOffset.

Valore restituito

Valore Int32.

Esempio

-- The following example returns 5

Second(cast('22:35:5' as DateTime))

Truncate( expression )

Restituisce expression, con i valori dell'ora troncati.

Arguments

Tipo DateTime o DateTimeOffset.

Valore restituito

Tipo di expression.

Year( expression )

Restituisce la parte relativa all'anno di expression come YYYY Int32.

Arguments

Tipi DateTime e DateTimeOffset.

Valore restituito

Tipo 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 ulteriori informazioni, vedere Provider di dati .NET Framework per SQL Server (SqlClient) per le funzioni di Entity Framework.

Vedere anche

Concetti

Funzioni canoniche (Entity SQL)