Udostępnij przez


Funkcje daty i godziny

Dostawca danych programu .NET Framework dla SQL Server (SqlClient) udostępnia funkcje daty i czasu, które wykonują operacje na wartości wejściowej System.DateTime i zwracają wynik string, wartość liczbową lub System.DateTime. Te funkcje znajdują się w przestrzeni nazw SqlServer, która jest dostępna podczas korzystania z programu SqlClient. Właściwość przestrzeni nazw dostawcy umożliwia programowi Entity Framework wykrywanie, który prefiks jest używany przez tego dostawcę dla określonych konstrukcji, takich jak typy i funkcje. W poniższej tabeli przedstawiono funkcje daty i czasu w SqlClient.

Funkcja Opis
DATEADD(datepart, number, date) Zwraca nową DateTime wartość opartą na dodawaniu interwału do określonej daty.

Argumenty

datepart: element String reprezentujący część daty, w której ma być zwracana nowa wartość.

number: wartość Int32, Int64, Decimal lub Double używana do inkrementacji datepart.

date: Wyrażenie zwracające DateTime, DateTimeOffset lub Time z dokładnością = [0–7] lub ciąg znaków w formacie daty.

Zwracana wartość

Nowa wartość DateTime lub DateTimeOffset lub Time o precyzji = [0–7].

Przykład

SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF(datepart,startdate,enddate) Zwraca liczbę granic daty i godziny przekraczanych między dwiema określonymi datami.

Argumenty

datepart: element String reprezentujący część daty do obliczenia różnicy.

startdate: Data początkowa do obliczenia jest wyrażeniem, które zwraca wartość DateTime, DateTimeOffset lub Time o dokładności = [0–7], lub ciąg znaków w formacie daty.

enddate: Data zakończenia obliczeń to wyrażenie, które zwraca wartość DateTime, DateTimeOffset lub Time z precyzją = [0-7], lub ciąg znaków w formacie daty.

Zwracana wartość

Jeden Int32.

Przykład

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

cast('6/20/2006' as DateTime))
DATENAME(datepart, date) Zwraca ciąg znaków reprezentujący określoną część daty.

Argumenty

datepart: element String reprezentujący część daty, w której ma być zwracana nowa wartość.

date: wyrażenie zwracające wartość DateTime,, DateTimeOffset, lub Time o precyzji = [0–7], lub ciąg znaków w formacie daty.

Zwracana wartość

Ciąg znaków reprezentujący dokładnie określoną część składową daty.

Przykład

SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART(datepart, date) Zwraca liczbę całkowitą reprezentującą określoną część podanej daty.

Argumenty

datepart: element String reprezentujący część daty, w której ma być zwracana nowa wartość.

date: wyrażenie zwracające wartość DateTime,, DateTimeOffset, lub Time o precyzji [0–7] lub ciąg znaków w formacie daty.

Zwracana wartość

Określona część daty określonej jako Int32.

Przykład

SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))
DAY(date) Zwraca dzień określonej daty jako liczbę całkowitą.

Argumenty

date:Wyrażenie typu DateTime lub DateTimeOffset z dokładnością = 0–7.

Zwracana wartość

Dzień wskazanej daty to Int32.

Przykład

SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE() Tworzy bieżącą datę i godzinę w wewnętrznym formacie programu SQL Server dla wartości daty/godziny.

Zwracana wartość

Bieżąca data i godzina systemu jako DateTime z dokładnością do 3 miejsc po przecinku.

Przykład

SqlServer.GETDATE()
GETUTCDATE() Tworzy wartość daty/godziny w formacie UTC (uniwersalny czas koordynowany lub średni czas Greenwich).

Zwracana wartość

Wartość DateTime z dokładnością do 3 w formacie UTC.

Przykład

SqlServer.GETUTCDATE()
MONTH(date) Zwraca miesiąc określonej daty jako liczbę całkowitą.

Argumenty

date:Wyrażenie typu DateTime lub DateTimeOffset z dokładnością = 0–7.

Zwracana wartość

Miesiąc określonej daty jako Int32.

Przykład

SqlServer.MONTH(cast('6/9/2006' as DateTime))
YEAR(date) Zwraca rok określonej daty jako liczbę całkowitą.

Argumenty

date:Wyrażenie typu DateTime lub DateTimeOffset z dokładnością = 0–7.

Zwracana wartość

Rok wskazanej daty jako Int32.

Przykład

SqlServer.YEAR(cast('6/9/2006' as DateTime))
SYSDATETIME() DateTime Zwraca wartość z dokładnością 7.

Zwracana wartość

Wartość DateTime z dokładnością do 7 cyfr.

Przykład

SqlServer.SYSDATETIME()
SYSUTCDATE() Tworzy wartość daty/godziny w formacie UTC (uniwersalny czas koordynowany lub średni czas Greenwich).

Zwracana wartość

Wartość DateTime z dokładnością = 7 w formacie UTC.

Przykład

SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET() Zwraca DateTimeOffset o dokładności 7.

Zwracana wartość

DateTimeOffset Wartość z dokładnością do 7 w formacie UTC.

Przykład

SqlServer.SYSDATETIMEOFFSET()

Aby uzyskać więcej informacji na temat funkcji daty i godziny obsługiwanej przez program SqlClient, zobacz Typy danych i funkcje daty i godziny (Transact-SQL).

Zobacz także