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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
SYSDATETIME() |
Gibt einen DateTime-Wert mit einer Genauigkeit von 7 zurück. Rückgabewert Ein DateTime-Wert mit einer Genauigkeit von 7. Beispiel
|
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
|
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
|
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 |
|---|---|---|
Siehe auch
Konzepte
.NET Framework-Datenanbieter für SQL Server (SqlClient) für die Entity Framework-Funktionen