Datum- en tijdfuncties
De .NET Framework-gegevensprovider voor SQL Server (SqlClient) biedt datum- en tijdfuncties waarmee bewerkingen worden uitgevoerd op een System.DateTime invoerwaarde en een string, numeriek of System.DateTime waarderesultaat worden geretourneerd. Deze functies bevinden zich in de SqlServer-naamruimte, die beschikbaar is wanneer u SqlClient gebruikt. Met de eigenschap naamruimte van een provider kan het Entity Framework detecteren welk voorvoegsel door deze provider wordt gebruikt voor specifieke constructies, zoals typen en functies. In de volgende tabel ziet u de datum- en tijdfuncties van SqlClient.
| Functie | Beschrijving |
|---|---|
DATEADD(datepart, number, date) |
Retourneert een nieuwe DateTime waarde die is gebaseerd op het toevoegen van een interval aan de opgegeven datum.Argumenten datepart: Een String waarde die het deel aangeeft van de datum waarop een nieuwe waarde moet worden geretourneerd.number: De Int32, Int64, Decimalof Double waarde die wordt gebruikt om te verhogen datepart.date:Een expressie die een DateTimeof, of DateTimeOffsetTime met precisie = [0-7] of een tekenreeks in een datumnotatie retourneert.Retourwaarde Een nieuwe DateTimeof , of DateTimeOffsetTime waarde met precisie = [0-7].Voorbeeld SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime)) |
DATEDIFF(datepart,startdate,enddate) |
Retourneert het aantal datum- en tijdgrenzen tussen twee opgegeven datums. Argumenten datepart: Een String die het deel van de datum aangeeft om het verschil te berekenen.startdate: Een begindatum voor de berekening is een expressie die een DateTimeof, of DateTimeOffsetTime een waarde met precisie = [0-7] of een tekenreeks in een datumnotatie retourneert.enddate:Een einddatum voor de berekening is een expressie die een DateTimeof, of DateTimeOffsetTime een waarde met precisie = [0-7] of een tekenreeks in een datumnotatie retourneert.Retourwaarde Een Int32.Voorbeeld SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime),cast('6/20/2006' as DateTime)) |
DATENAME(datepart, date) |
Retourneert een tekenreeks die het opgegeven datumgedeelte van de opgegeven datum aangeeft. Argumenten datepart: Een String waarde die het deel aangeeft van de datum waarop een nieuwe waarde moet worden geretourneerd.date: Een expressie die een DateTime, of DateTimeOffset, of Time een waarde met precisie = [0-7] of een tekenreeks in een datumnotatie retourneert.Retourwaarde De tekenreeks die het opgegeven datumgedeelte van de opgegeven datum aangeeft. Voorbeeld SqlServer.DATENAME('year', cast('6/9/2006' as DateTime)) |
DATEPART(datepart, date) |
Retourneert een geheel getal dat het opgegeven datumgedeelte van de opgegeven datum aangeeft. Argumenten datepart: Een String waarde die het deel aangeeft van de datum waarop een nieuwe waarde moet worden geretourneerd.date: Een expressie die een DateTime, of DateTimeOffset, Time waarde retourneert met precisie = [0-7], of een tekenreeks in een datumnotatie.Retourwaarde Het opgegeven datumgedeelte van de opgegeven datum, als een Int32.Voorbeeld SqlServer.DATEPART('year', cast('6/9/2006' as DateTime)) |
DAY(date) |
Retourneert de dag van de opgegeven datum als een geheel getal. Argumenten date:Een expressie van het type DateTime of DateTimeOffset met precisie = 0-7.Retourwaarde De dag van de opgegeven datum als een Int32.Voorbeeld SqlServer.DAY(cast('6/9/2006' as DateTime)) |
GETDATE() |
Produceert de huidige datum en tijd in interne SQL Server-indeling voor datum/tijd-waarden. Retourwaarde De huidige systeemdatum en -tijd als een met DateTime precisie van 3.Voorbeeld SqlServer.GETDATE() |
GETUTCDATE() |
Produceert de datum/tijd-waarde in utc-indeling (Coordinated Universal Time of Greenwich Mean Time). Retourwaarde De DateTime waarde met een precisie van 3 in UTC-indeling.Voorbeeld SqlServer.GETUTCDATE() |
MONTH(date) |
Retourneert de maand van de opgegeven datum als een geheel getal. Argumenten date:Een expressie van het type DateTime of DateTimeOffset met precisie = 0-7.Retourwaarde De maand van de opgegeven datum als een Int32.Voorbeeld SqlServer.MONTH(cast('6/9/2006' as DateTime)) |
YEAR(date) |
Retourneert het jaar van de opgegeven datum als een geheel getal. Argumenten date:Een expressie van het type DateTime of DateTimeOffset met precisie = 0-7.Retourwaarde Het jaar van de opgegeven datum als een Int32.Voorbeeld SqlServer.YEAR(cast('6/9/2006' as DateTime)) |
SYSDATETIME() |
Retourneert een DateTime waarde met een precisie van 7.Retourwaarde Een DateTime waarde met een precisie van 7.Voorbeeld SqlServer.SYSDATETIME() |
SYSUTCDATE() |
Produceert de datum/tijd-waarde in utc-indeling (Coordinated Universal Time of Greenwich Mean Time). Retourwaarde De DateTime waarde met precisie = 7 in UTC-indeling.Voorbeeld SqlServer.SYSUTCDATE() |
SYSDATETIMEOFFSET() |
Retourneert een DateTimeOffset met een precisie van 7.Retourwaarde Een DateTimeOffset waarde met precisie van 7 in UTC-indeling.Voorbeeld SqlServer.SYSDATETIMEOFFSET() |
Zie Datum- en tijdgegevenstypen en -functies (Transact-SQL) voor meer informatie over de datum- en tijdfuncties die door SqlClient worden ondersteund.