Freigeben über


Datums- und Uhrzeitfunktionen

Der .NET Framework-Datenanbieter für SQL Server (SqlClient) stellt Datums- und Uhrzeitfunktionen bereit, die Vorgänge für einen System.DateTime Eingabewert ausführen und ein stringnumerisches oder System.DateTime Wertergebnis zurückgeben. Diese Funktionen befinden sich im SqlServer-Namespace, der verfügbar ist, wenn Sie SqlClient verwenden. Mit der Namespaceeigenschaft eines Anbieters kann Entity Framework ermitteln, welches Präfix von diesem Anbieter für bestimmte Konstrukte verwendet wird, z. B. Typen und Funktionen. Die folgende Tabelle zeigt die SqlClient-Datums- und Uhrzeitfunktionen.

Funktion BESCHREIBUNG
DATEADD(datepart, number, date) Gibt einen neuen DateTime-Wert zurück, der auf dem Hinzufügen eines Intervalls zum angegebenen Datum basiert.

Argumente

datepart: A String , das den Teil des Datums darstellt, an dem 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 ein DateTime, DateTimeOffset oder Time mit Genauigkeit = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt.

Rückgabewert

Ein neuer DateTime, ein DateTimeOffset oder ein Time Wert mit einer Genauigkeit = [0-7].

Beispiel

SqlServer.DATEADD('day', 22, cast('6/9/2006' as DateTime))
DATEDIFF(datepart,startdate,enddate) Gibt die Anzahl der Datums- und Zeitgrenzen zurück, die zwischen zwei angegebenen Daten überschritten wurden.

Argumente

datepart: Ein String, der den Teil des Datums zur Berechnung der Differenz darstellt.

startdate: Ein Anfangstermin für die Berechnung ist ein Ausdruck, der einen DateTimeoder DateTimeOffsetTime einen Wert mit Genauigkeit = [0-7] oder eine Zeichenfolge in einem Datumsformat zurückgibt.

enddate: Ein Enddatum für die Berechnung ist ein Ausdruck, der einen DateTimeoder DateTimeOffseteinen Time Wert mit Genauigkeit = [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 angegebenen Datumsabschnitt des angegebenen Datums darstellt.

Argumente

datepart: A String , das den Teil des Datums darstellt, an dem ein neuer Wert zurückgegeben werden soll.

date: Ein Ausdruck, der einen DateTime,-, einen DateTimeOffset- oder einen Time-Wert mit Genauigkeit = [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 Teil des angegebenen Datums darstellt.

Argumente

datepart: A String , das den Teil des Datums darstellt, an dem ein neuer Wert zurückgegeben werden soll.

date: Ein Ausdruck, der einen DateTime,- oder DateTimeOffset,-Wert mit Genauigkeit = [0-7] oder eine Time-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 ganze Zahl zurück.

Argumente

date:Ein Ausdruck vom Typ DateTime oder DateTimeOffset mit Genauigkeit = 0-7.

Rückgabewert

Der Tag des angegebenen Datums als Int32-Wert.

Beispiel

SqlServer.DAY(cast('6/9/2006' as DateTime))
GETDATE() Erzeugt das aktuelle Datum und die aktuelle Uhrzeit im internen SQL Server-Format für Datums-/Uhrzeitwerte.

Rückgabewert

Das aktuelle Systemdatum und die aktuelle Systemzeit als DateTime-Wert mit einer Genauigkeit von 3.

Beispiel

SqlServer.GETDATE()
GETUTCDATE() Erzeugt den Datetime-Wert im UTC-Format (Coordinated Universal Time oder Greenwich Mean Time).

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 ganze Zahl zurück.

Argumente

date:Ein Ausdruck vom Typ DateTime oder DateTimeOffset mit Genauigkeit = 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 ganze Zahl zurück.

Argumente

date:Ein Ausdruck vom Typ DateTime oder DateTimeOffset mit Genauigkeit = 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() Erzeugt den Datetime-Wert im UTC-Format (Coordinated Universal Time oder Greenwich Mean Time).

Rückgabewert

Der DateTime-Wert mit einer Genauigkeit von = 7 im UTC-Format.

Beispiel

SqlServer.SYSUTCDATE()
SYSDATETIMEOFFSET() Gibt eine DateTimeOffset 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 unter Datums- und Uhrzeitdatentypen und -funktionen (Transact-SQL).

Siehe auch