Condividi tramite


Funzioni di data e ora

Il provider di dati .NET Framework per SQL Server (SqlClient) fornisce funzioni di data e ora che eseguono operazioni su un valore di input System.DateTime e restituiscono un risultato string, numerico o valore System.DateTime. Queste funzioni si trovano nello spazio dei nomi SqlServer, disponibile quando si usa SqlClient. La proprietà dello spazio dei nomi di un provider consente a Entity Framework di individuare il prefisso usato da questo provider per costrutti specifici, ad esempio tipi e funzioni. La tabella seguente illustra le funzioni di data e ora di SqlClient.

Funzione Descrizione
DATEADD(datepart, number, date) Restituisce un nuovo valore DateTime, basato sull'aggiunta di un intervallo alla data specificata.

Argomenti

Un datepart che rappresenta la parte della data su cui String deve restituire un nuovo valore.

number: valore Int32, Int64, Decimalo Double usato per incrementare datepart.

date: Un'espressione che restituisce un DateTime, o DateTimeOffset, o Time con precisione = [0-7], o una stringa di caratteri in un formato data.

Valore Restituito

DateTime Un nuovo valore, oppure DateTimeOffset, oppure Time con precisione = [0-7].

Esempio

SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF(datepart,startdate,enddate) Restituisce il numero di limiti di data e ora superati tra due date specificate.

Argomenti

datepart: Un String che rappresenta la parte della data per calcolare la differenza.

startdate: una data di inizio per il calcolo è un'espressione che restituisce un DateTimevalore , o DateTimeOffseto Time con precisione = [0-7], o una stringa di caratteri in un formato di data.

enddate: Una data di fine per il calcolo è un'espressione che restituisce un DateTimevalore , o DateTimeOffseto Time con precisione = [0-7], o una stringa di caratteri in un formato data.

Valore Restituito

Un oggetto Int32.

Esempio

SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),

cast('6/20/2006' as DateTime))
DATENAME(datepart, date) Restituisce una stringa di caratteri che rappresenta il valore datepart specificato della data specificata.

Argomenti

Un datepart che rappresenta la parte della data su cui String deve restituire un nuovo valore.

date: espressione che restituisce un DateTime, valore o DateTimeOffseto Time con precisione = [0-7], o una stringa di caratteri in un formato di data.

Valore Restituito

Stringa di caratteri che rappresenta il datepart specificato della data indicata.

Esempio

SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART(datepart, date) Restituisce un numero intero che rappresenta il valore datepart specificato della data specificata.

Argomenti

Un datepart che rappresenta la parte della data su cui String deve restituire un nuovo valore.

date: un'espressione che restituisce un valore DateTime,, DateTimeOffset, o Time con precisione = [0-7], o una stringa di caratteri in formato data.

Valore Restituito

Il datepart specificato della data indicata, in qualità di Int32.

Esempio

SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))
DAY(date) Restituisce il giorno della data specificata come numero intero.

Argomenti

date:Espressione di tipo DateTime o DateTimeOffset con precisione = 0-7.

Valore Restituito

Il giorno della data specificata come Int32.

Esempio

SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE() Produce la data e l'ora correnti nel formato interno di SQL Server per i valori datetime.

Valore Restituito

La data e l'ora di sistema correnti come DateTime, con una precisione di 3.

Esempio

SqlServer.GETDATE()
GETUTCDATE() Produce il valore datetime nel formato UTC (Coordinated Universal Time o Greenwich Mean Time).

Valore Restituito

Valore DateTime con una precisione di 3 cifre in formato UTC.

Esempio

SqlServer.GETUTCDATE()
MONTH(date) Restituisce il mese della data specificata come numero intero.

Argomenti

date:Espressione di tipo DateTime o DateTimeOffset con precisione = 0-7.

Valore Restituito

Mese della data specificata come Int32.

Esempio

SqlServer.MONTH(cast('6/9/2006' as DateTime))
YEAR(date) Restituisce l'anno della data specificata come numero intero.

Argomenti

date:Espressione di tipo DateTime o DateTimeOffset con precisione = 0-7.

Valore Restituito

L'anno della data specificata come Int32.

Esempio

SqlServer.YEAR(cast('6/9/2006' as DateTime))
SYSDATETIME() Restituisce un DateTime valore con precisione 7.

Valore Restituito

Un valore DateTime con una precisione di 7.

Esempio

SqlServer.SYSDATETIME()
SYSUTCDATE() Produce il valore datetime nel formato UTC (Coordinated Universal Time o Greenwich Mean Time).

Valore Restituito

Valore DateTime in formato UTC con precisione = 7.

Esempio

SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET() Restituisce un oggetto DateTimeOffset con una precisione pari a 7.

Valore Restituito

Un valore DateTimeOffset con una precisione di 7 in formato UTC.

Esempio

SqlServer.SYSDATETIMEOFFSET()

Per altre informazioni sulle funzioni di data e ora supportate da SqlClient, vedere Funzioni e tipi di dati di data e ora (Transact-SQL).

Vedere anche