Dela via


Datum- och tidsfunktioner

.NET Framework-dataprovidern för SQL Server (SqlClient) tillhandahåller datum- och tidsfunktioner som utför åtgärder på ett System.DateTime indatavärde och returnerar ett string, numeriskt eller System.DateTime värderesultat. Dessa funktioner finns i SqlServer-namnområdet, som är tillgängligt när du använder SqlClient. Med en providers namnområdesegenskap kan Entity Framework identifiera vilket prefix som används av den här providern för specifika konstruktioner, till exempel typer och funktioner. I följande tabell visas datum- och tidsfunktionerna för SqlClient.

Function beskrivning
DATEADD(datepart, number, date) Returnerar ett nytt DateTime värde som baseras på att lägga till ett intervall till det angivna datumet.

Argument

datepart: En String som representerar den del av datumet då ett nytt värde ska returneras.

number: Värdet Int32, Int64, Decimaleller Double som används för att öka datepart.

date: Ett uttryck som returnerar ett DateTime, eller DateTimeOffset, eller Time med precision = [0–7], eller en teckensträng i ett datumformat.

Returvärde

Ett nytt DateTime, eller DateTimeOffset, eller Time -värde med precision = [0–7].

Exempel

SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF(datepart,startdate,enddate) Returnerar antalet datum- och tidsgränser som korsas mellan två angivna datum.

Argument

datepart: En String som representerar delen av datumet för att beräkna skillnaden.

startdate: Ett startdatum för beräkningen är ett uttryck som returnerar ett DateTime, eller DateTimeOffset, eller Time -värde med precision = [0–7], eller en teckensträng i ett datumformat.

enddate: Ett slutdatum för beräkningen är ett uttryck som returnerar ett DateTime, eller DateTimeOffset, eller Time -värde med precision = [0–7], eller en teckensträng i ett datumformat.

Returvärde

En Int32.

Exempel

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

cast('6/20/2006' as DateTime))
DATENAME(datepart, date) Returnerar en teckensträng som representerar den angivna datumdelen för det angivna datumet.

Argument

datepart: En String som representerar den del av datumet då ett nytt värde ska returneras.

date: Ett uttryck som returnerar ett DateTime, eller DateTimeOffset, eller-värde Time med precision = [0–7], eller en teckensträng i ett datumformat.

Returvärde

Teckensträngen som representerar den angivna datumdelen för det angivna datumet.

Exempel

SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART(datepart, date) Returnerar ett heltal som representerar den angivna datumdelen för det angivna datumet.

Argument

datepart: En String som representerar den del av datumet då ett nytt värde ska returneras.

date: Ett uttryck som returnerar ett DateTime, eller DateTimeOffset, eller Time -värde med precision = [0–7], eller en teckensträng i ett datumformat.

Returvärde

Den angivna datumdelen för det angivna datumet, som en Int32.

Exempel

SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))
DAY(date) Returnerar dagen för det angivna datumet som ett heltal.

Argument

date:Ett uttryck av typen DateTime eller DateTimeOffset med precision = 0–7.

Returvärde

Dagen för det angivna datumet som en Int32.

Exempel

SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE() Genererar aktuellt datum och tid i internt SQL Server-format för datetime-värden.

Returvärde

Det aktuella systemets datum och tid som en DateTime med precisionen 3.

Exempel

SqlServer.GETDATE()
GETUTCDATE() Genererar datetime-värdet i UTC-format (Coordinated Universal Time eller Greenwich Mean Time).

Returvärde

Värdet DateTime med precisionen 3 i UTC-format.

Exempel

SqlServer.GETUTCDATE()
MONTH(date) Returnerar månaden för det angivna datumet som ett heltal.

Argument

date:Ett uttryck av typen DateTime eller DateTimeOffset med precision = 0–7.

Returvärde

Månaden för det angivna datumet som en Int32.

Exempel

SqlServer.MONTH(cast('6/9/2006' as DateTime))
YEAR(date) Returnerar året för det angivna datumet som ett heltal.

Argument

date:Ett uttryck av typen DateTime eller DateTimeOffset med precision = 0–7.

Returvärde

Året för det angivna datumet som .Int32

Exempel

SqlServer.YEAR(cast('6/9/2006' as DateTime))
SYSDATETIME() Returnerar ett DateTime värde med precisionen 7.

Returvärde

Ett DateTime värde med precisionen 7.

Exempel

SqlServer.SYSDATETIME()
SYSUTCDATE() Genererar datetime-värdet i UTC-format (Coordinated Universal Time eller Greenwich Mean Time).

Returvärde

Värdet DateTime med precision = 7 i UTC-format.

Exempel

SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET() Returnerar en DateTimeOffset med precisionen 7.

Returvärde

Ett DateTimeOffset värde med precisionen 7 i UTC-format.

Exempel

SqlServer.SYSDATETIMEOFFSET()

Mer information om de datum- och tidsfunktioner som SqlClient stöder finns i Datatyper och funktioner för datum och tid (Transact-SQL).

Se även