Funkce dat a času

Zprostředkovatel dat rozhraní .NET Framework pro SQL Server (SqlClient) poskytuje funkce data a času, které provádějí operace se System.DateTime vstupní hodnotou a vracejí stringvýsledek , číselnou hodnotu nebo 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 Entity Framework zjistit, jaká předpona je používána tímto zprostředkovatelem pro určité konstrukce, jako jsou typy a funkce. Následující tabulka ukazuje funkce data a času SqlClient.

Funkce Popis
DATEADD(datepart, number, date) Vrátí novou DateTime hodnotu založenou na přidání intervalu k zadanému datu.

Argumenty

datepart: String představuje část data, pro kterou se má vrátit nová hodnota.

number: Int32, Int64, Decimal nebo Double hodnota použitá ke zvýšení datepart.

date: Výraz, který vrací DateTime, nebo DateTimeOffset, nebo Time s přesností = [0-7], nebo řetězec znaků ve formátu kalendářního data.

návratová hodnota

Nová hodnota DateTime, nebo DateTimeOffset, nebo Time 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: String, která představuje část data, která se používá 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

Nějaký Int32.

Příklad

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

cast('6/20/2006' as DateTime))
DATENAME(datepart, date) Vrátí řetězec znaků představující specifickou část zadaného data.

Argumenty

datepart: String představuje část data, pro kterou se má vrátit nová hodnota.

date: Výraz, který vrací DateTime, nebo DateTimeOffset, nebo Time hodnotu s přesností = [0-7], nebo řetězec znaků ve formátu data.

návratová hodnota

Znakový řetězec představující zadaný díl dané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 zadaného data.

Argumenty

datepart: String představuje část data, pro kterou se má vrátit nová hodnota.

date: Výraz, který vrací hodnotu DateTime,, DateTimeOffset, nebo Time s přesností = [0-7], nebo řetězec znaků ve formátu data.

návratová hodnota

Zadaná část data zadaného data jako Int32.

Pří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 'datum a čas'.

návratová hodnota

Aktuální systémové datum a čas jako DateTime s přesností 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 Int32.

Pří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).

Viz také