Funkce data a času
Rozhraní .NET Framework Zprostředkovatel dat pro SQL Server (SqlClient) poskytuje funkce pro datum a čas, které provádějí operace se System.DateTime vstupní hodnotou a vrací , číselný stringnebo System.DateTime výsledek hodnoty. Tyto funkce jsou v oboru názvů SqlServer, který je k dispozici při použití SqlClient. Vlastnost oboru názvů zprostředkovatele umožňuje Rozhraní Entity Framework zjistit, která předpona je používána tímto zprostředkovatelem pro konkrétní konstrukce, jako jsou typy a funkce. Následující tabulka ukazuje funkce data a času SqlClient.
| Function | Popis |
|---|---|
DATEADD(datepart, number, date) |
Vrátí novou DateTime hodnotu založenou na přidání intervalu k zadanému datu.Argumenty datepart: Představuje String část data, kdy se má vrátit nová hodnota.numberInt32: , , Int64Decimalnebo Double hodnota použitá k přírůstku datepart.date:Výraz, který vrací DateTimehodnotu , nebo DateTimeOffsetTime s přesností = [0-7], nebo řetězec znaků ve formátu kalendářního data.Návratová hodnota Nová DateTimehodnota nebo DateTimeOffsetTime nebo hodnota s přesností = [0-7].Příklad SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime)) |
DATEDIFF(datepart,startdate,enddate) |
Vrátí počet hranic data a času překračovaných mezi dvěma zadanými daty. Argumenty datepart: A String , která představuje část data pro výpočet rozdílu.startdate: Počáteční datum pro výpočet je výraz, který vrací DateTimehodnotu nebo DateTimeOffsetTime hodnotu s přesností = [0-7], nebo řetězec znaků ve formátu data.enddate:Koncové datum pro výpočet je výraz, který vrací DateTimehodnotu nebo DateTimeOffsetTime hodnotu s přesností = [0-7], nebo řetězec znaků ve formátu kalendářního data.Návratová hodnota A Int32.Příklad SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),cast('6/20/2006' as DateTime)) |
DATENAME(datepart, date) |
Vrátí znakový řetězec představující zadanou část data zadaného data. Argumenty datepart: Představuje String část data, kdy se má vrátit nová hodnota.date: Výraz, který vrací DateTime, hodnotu nebo DateTimeOffsethodnotu Time s přesností = [0-7], nebo řetězec znaků ve formátu data.Návratová hodnota Znakový řetězec představující zadanou část data zadaného data. Příklad SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
Vrátí celé číslo, které představuje zadanou část data zadaného data. Argumenty datepart: Představuje String část data, kdy se má vrátit nová hodnota.date: Výraz, který vrací DateTime, hodnotu nebo DateTimeOffset, Time hodnotu s přesností = [0-7], nebo řetězec znaků ve formátu data.Návratová hodnota Zadaná část data zadaného data jako . Int32Příklad SqlServer.DATEPART('year', cast('6/9/2006' as DateTime)) |
DAY(date) |
Vrátí den zadaného data jako celé číslo. Argumenty date:Výraz typu DateTime nebo DateTimeOffset s přesností = 0-7.Návratová hodnota Den zadaného data jako Int32.Příklad SqlServer.DAY(cast('6/9/2006' as DateTime)) |
GETDATE() |
Vytvoří aktuální datum a čas v interním formátu SQL Serveru pro hodnoty data a času. Návratová hodnota Aktuální systémové datum a čas s přesností DateTime na 3.Příklad SqlServer.GETDATE() |
GETUTCDATE() |
Vytvoří hodnotu datetime ve formátu UTC (Coordinated Universal Time nebo Greenwich Mean Time). Návratová hodnota Hodnota DateTime s přesností 3 ve formátu UTC.Příklad SqlServer.GETUTCDATE() |
MONTH(date) |
Vrátí měsíc zadaného data jako celé číslo. Argumenty date:Výraz typu DateTime nebo DateTimeOffset s přesností = 0-7.Návratová hodnota Měsíc zadaného data jako . Int32Příklad SqlServer.MONTH(cast('6/9/2006' as DateTime)) |
YEAR(date) |
Vrátí rok zadaného data jako celé číslo. Argumenty date:Výraz typu DateTime nebo DateTimeOffset s přesností = 0-7.Návratová hodnota Rok zadaného data jako Int32.Příklad SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
DateTime Vrátí hodnotu s přesností 7.Návratová hodnota Hodnota DateTime s přesností 7.Příklad SqlServer.SYSDATETIME() |
SYSUTCDATE() |
Vytvoří hodnotu datetime ve formátu UTC (Coordinated Universal Time nebo Greenwich Mean Time). Návratová hodnota Hodnota DateTime s přesností = 7 ve formátu UTC.Příklad SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
DateTimeOffset Vrátí hodnotu s přesností 7.Návratová hodnota DateTimeOffset Hodnota s přesností 7 ve formátu UTC.Příklad SqlServer.SYSDATETIMEOFFSET() |
Další informace o funkcích data a času, které SqlClient podporuje, najdete v tématu Datové typy a funkce data a času (Transact-SQL).