Funkcje daty i godziny
Program .NET Framework Dostawca danych dla programu SQL Server (SqlClient) udostępnia funkcje daty i godziny, które wykonują operacje na wartości wejściowej System.DateTime i zwracają stringwynik , liczbowy lub System.DateTime wartość. 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 godziny SqlClient.
| Function | 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ść.numberInt32: wartość , , DecimalInt64lub Double używana do inkrementacji datepart.date: Wyrażenie zwracające DateTimewyrażenie , lub DateTimeOffsetz Time dokładnością = [0–7] lub ciąg znaków w formacie daty.Wartość zwracana Nowa DateTimewartość , lub lub DateTimeOffsetTime 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 obliczenia jest wyrażeniem, które zwraca DateTimewartość , lub z DateTimeOffsetTime dokładnością = [0–7] lub ciąg znaków w formacie daty.enddate:Data zakończenia obliczenia to wyrażenie, które zwraca DateTimewartość , lub o DateTimeOffsetTime precyzji = [0–7] lub ciąg znaków w formacie daty.Wartość zwracana An 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 DateTime, wartość lub lub DateTimeOffsetTime o precyzji = [0–7] lub ciąg znaków w formacie daty.Wartość zwracana Ciąg znaków reprezentujący określoną część daty. Przykład SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
Zwraca liczbę całkowitą reprezentującą określoną część daty określonej daty. Argumenty datepart: element String reprezentujący część daty, w której ma być zwracana nowa wartość.date: wyrażenie zwracające DateTime, wartość lub lub DateTimeOffset, Time o precyzji = [0–7] lub ciąg znaków w formacie daty.Wartość zwracana 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.Wartość zwracana Dzień określonej daty jako 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. Wartość zwracana Bieżąca data i godzina systemu z DateTime dokładnością 3.Przykład SqlServer.GETDATE() |
GETUTCDATE() |
Tworzy wartość daty/godziny w formacie UTC (uniwersalny czas koordynowany lub średni czas Greenwich). Wartość zwracana 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.Wartość zwracana 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.Wartość zwracana Rok określonej daty jako Int32.Przykład SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
DateTime Zwraca wartość z dokładnością 7.Wartość zwracana DateTime Wartość z dokładnością 7.Przykład SqlServer.SYSDATETIME() |
SYSUTCDATE() |
Tworzy wartość daty/godziny w formacie UTC (uniwersalny czas koordynowany lub średni czas Greenwich). Wartość zwracana Wartość DateTime z dokładnością = 7 w formacie UTC.Przykład SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
Zwraca wartość z DateTimeOffset dokładnością 7.Wartość zwracana 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).