Datums- und Uhrzeitfunktionen (Entity SQL)

Der .NET Framework-Datenanbieter für SQL Server (SqlClient) stellt Funktionen für Datum und Uhrzeit bereit, die einen System.DateTime-Eingabewert verarbeiten und ein Ergebnis vom Typ string oder System.DateTime bzw. einen numerischen Wert zurückgeben. Diese Funktionen befinden sich im SQLServer-Namespace, der bei der Verwendung von SqlClient verfügbar ist. Mit der Namespace-Eigenschaft eines Anbieters kann das Entity Framework ermitteln, welches Präfix von diesem Anbieter für bestimmte Konstrukte verwendet wird, z. B. Typen und Funktionen. In der folgenden Tabelle werden die Datums- und Uhrzeitfunktionen von SqlClient angezeigt.

Funktion	Beschreibung
DATEADD( datepart, number, date)	Gibt einen neuen DateTime-Wert zurück, der berechnet wird, indem zum angegebenen Datum ein Intervall addiert wird. Argumente datepart: Ein String der den Teil des Datums angibt, für den ein neuer Wert zurückgegeben werden soll. number: Der Int32-, Int64-, Decimal- oder Double-Wert, der zur Steigerung von datepart verwendet wird. date: Ein Ausdruck, der DateTime, DateTimeOffset oder Time mit einer Genauigkeit von = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt. Rückgabewert Ein neuer DateTime-, DateTimeOffset- oder Time-Wert mit einer Genauigkeit von = [0-7]. Beispiel SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF( datepart, startdate, enddate)	Gibt die Anzahl der Datums- und Uhrzeitbegrenzungen zurück, die zwischen zwei angegebenen Datumsangaben überschritten werden. Argumente datepart: Ein String, der den Teil des Datums zur Berechnung der Differenz darstellt. startdate: Das Startdatum für die Berechnung ist ein Ausdruck, der DateTime, DateTimeOffset, oder Time mit einer Genauigkeit von = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt. enddate: : Das Enddatum für die Berechnung ist ein Ausdruck, der DateTime, DateTimeOffset, oder Time mit einer Genauigkeit von = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt. Rückgabewert Int32 Beispiel SqlServer.DATEDIFF('day', cast('6/9/2006' as DateTime), cast('6/20/2006' as DateTime))
DATENAME( datepart, date)	Gibt eine Zeichenfolge zurück, die den Datumsteil des angegebenen Datums darstellt. Argumente datepart: Ein String, der den Teil des Datums angibt, für den ein neuer Wert zurückgegeben werden soll. date: Ein Ausdruck, der den DateTime,-, DateTimeOffset- oder Time-Wert mit einer Genauigkeit von = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt. Rückgabewert Die Zeichenfolge, die den angegebenen Datumsteil des angegebenen Datums darstellt. Beispiel SqlServer.DATENAME('year', cast('6/9/2006' as DateTime))
DATEPART( datepart, date)	Gibt eine ganze Zahl zurück, die den angegebenen DatePart-Wert des angegebenen Datums darstellt. Argumente datepart: Ein String, der den Teil des Datums angibt, für den ein neuer Wert zurückgegeben werden soll. date: Ein Ausdruck, der den DateTime,-, DateTimeOffset,- oder Time-Wert mit einer Genauigkeit von = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt. Rückgabewert Der angegebene Datumsteil des angegebenen Datums als Int32-Wert. Beispiel SqlServer.DATEPART('year', cast('6/9/2006' as DateTime))
DAY( date )	Gibt den Tag des angegebenen Datums als Ganzzahl zurück. Argumente date: Ein Ausdruck vom Typ DateTime oder DateTimeOffset mit einer Genauigkeit von = 0-7. Rückgabewert Der Tag des angegebenen Datums als Int32-Wert. Beispiel SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE()	Erstellt die aktuellen Werte für Datum und Uhrzeit im internen SQL Server-Format für datetime-Werte. Rückgabewert Das aktuelle Systemdatum und die aktuelle Systemzeit als DateTime-Wert mit einer Genauigkeit von 3. Beispiel SqlServer.GETDATE()
GETUTCDATE()	Erstellt den datetime-Wert im UTC-Format (koordinierte Weltzeit oder GMT). Rückgabewert Der DateTime-Wert mit einer Genauigkeit von 3 im UTC-Format. Beispiel SqlServer.GETUTCDATE()
MONTH( date )	Gibt den Monat des angegebenen Datums als Ganzzahl zurück. Argumente date: Ein Ausdruck vom Typ DateTime oder DateTimeOffset mit einer Genauigkeit von = 0-7. Rückgabewert Der Monat des angegebenen Datums als Int32-Wert. Beispiel SqlServer.MONTH(cast('6/9/2006' as DateTime))
YEAR( date )	Gibt das Jahr des angegebenen Datums als Ganzzahl zurück. Argumente date: Ein Ausdruck vom Typ DateTime oder DateTimeOffset mit einer Genauigkeit von = 0-7. Rückgabewert Das Jahr des angegebenen Datums als Int32-Wert. Beispiel SqlServer.YEAR(cast('6/9/2006' as DateTime))
SYSDATETIME()	Gibt einen DateTime-Wert mit einer Genauigkeit von 7 zurück. Rückgabewert Ein DateTime-Wert mit einer Genauigkeit von 7. Beispiel SqlServer.SYSDATETIME()
SYSUTCDATE()	Erstellt den datetime-Wert im UTC-Format (koordinierte Weltzeit oder GMT). Rückgabewert Der DateTime-Wert mit einer Genauigkeit von = 7 im UTC-Format. Beispiel SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET()	Gibt einen DateTimeOffset-Wert mit einer Genauigkeit von 7 zurück. Rückgabewert Ein DateTimeOffset-Wert mit einer Genauigkeit von 7 im UTC-Format. Beispiel SqlServer.SYSDATETIMEOFFSET()

Weitere Informationen zu den von SqlClient unterstützten Datums- und Uhrzeitfunktionen finden Sie in der Dokumentation für die SQL Server-Version, die im SqlClient-Anbietermanifest angegeben wurde:

SQL Server 2000	SQL Server 2005	SQL Server 2008
Datums- und Uhrzeitfunktionen (Transact-SQL)	Datums- und Uhrzeitfunktionen (Transact-SQL)	Datums- und Uhrzeitfunktionen (Transact-SQL)

Siehe auch

Konzepte

.NET Framework-Datenanbieter für SQL Server (SqlClient) für die Entity Framework-Funktionen