Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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