Kanonische Funktionen für Datum und Zeit

Entity SQL enthält kanonische Datums- und Uhrzeitfunktionen.

Bemerkungen

Die folgende Tabelle zeigt die kanonischen Datums- und Uhrzeitfunktionen von Entity SQL. datetime ist ein DateTime-Wert.

Funktion BESCHREIBUNG
AddNanoseconds(expression,number) Fügt number den angegebenen expression-Wert (in Nanosekunden) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der expression-Typ.
AddMicroseconds(expression,number) Fügt dem number den angegebenen expression-Wert (in Mikrosekunden) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der expression-Typ.
AddMilliseconds(expression,number) Fügt dem number den angegebenen expression-Wert (in Millisekunden) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der expression-Typ.
AddSeconds(expression,number) Fügt dem number den angegebenen expression-Wert (in Sekunden) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der expression-Typ.
AddMinutes(expression,number) Fügt dem number den angegebenen expression-Wert (in Minuten) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der expression-Typ.
AddHours(expression,number) Fügt dem number den angegebenen expression-Wert (in Stunden) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der expression-Typ.
AddDays(expression,number) Fügt am Ende der number den angegebenen expression-Wert für die Tage hinzu.

Argumente

expression: DateTime oder DateTimeOffset.

number: Int32.

Rückgabewert

Der expression-Typ.
AddMonths(expression,number) Fügt dem number den angegebenen expression-Wert für die Monate hinzu.

Argumente

expression: DateTime oder DateTimeOffset.

number: Int32.

Rückgabewert

Der expression-Typ.
AddYears(expression,number) Fügt dem number den angegebenen expression-Wert für die Jahre hinzu.

Argumente

expression: DateTime oder DateTimeOffset.

number: Int32.

Rückgabewert

Der expression-Typ.
CreateDateTime(year,month,day,hour,minute,second) Gibt das aktuelle Datum und die aktuelle Zeit des Servers in der Zeitzone des Servers als neuen DateTime-Wert zurück.

Argumente

year, month, day, hour, minute: Int16 und Int32.

second: Double.

Rückgabewert

einen DateTime
CreateDateTimeOffset(year,month,day,hour,minute,second,tzoffset) Gibt einen neuen DateTimeOffset-Wert zurück, der das aktuelle Datum und die aktuelle Uhrzeit des Servers im Verhältnis zur koordinierten Weltzeit (UTC) darstellt.

Argumente

year, month, day, hour, minute, tzoffset: Int32.

second: Double.

Rückgabewert

einen DateTimeOffset
CreateTime(hour,minute,second) Gibt einen neuen Time-Wert als aktuelle Zeit zurück.

Argumente

hour und minute: Int32

second: Double.

Rückgabewert

einen Time
CurrentDateTime() Gibt das aktuelle Datum und die aktuelle Uhrzeit des Servers in der Zeitzone des Servers als DateTime-Wert zurück.

Rückgabewert

einen DateTime
CurrentDateTimeOffset() Gibt das aktuelle Datum, die aktuelle Uhrzeit sowie einen Offset als DateTimeOffset zurück.

Rückgabewert

einen DateTimeOffset
CurrentUtcDateTime() Gibt das aktuelle Datum und die aktuelle Zeit des Servers in der UTC-Zeitzone als DateTime-Wert zurück.

Rückgabewert

einen DateTime
Day(expression) Gibt den Tagteil von expression als Int32 zwischen 1 und 31 zurück.

Argumente

DateTime und DateTimeOffset.

Rückgabewert

Int32.

Beispiel

-- The following example returns 12.

Day(cast('03/12/1998' as DateTime))
DayOfYear(expression) Gibt den Tagteil von expression als Int32-Wert zwischen 1 und 366 zurück, wobei 366 für den letzten Tag eines Schaltjahrs zurückgegeben wird.

Argumente

DateTime oder DateTimeOffset.

Rückgabewert

Int32.
DiffNanoseconds(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Nanosekunden) zurück.

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffMilliseconds(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Millisekunden) zurück.

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffMicroseconds(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Mikrosekunden) zurück.

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffSeconds(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Sekunden) zurück.

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffMinutes(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Minuten) zurück.

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffHours(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Stunden) zurück.

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffDays(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Tagen) zurück.

Argumente

startExpression, endExpression: DateTime oder DateTimeOffset. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffMonths(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Monaten) zurück.

Argumente

startExpression, endExpression: DateTime oder DateTimeOffset. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
DiffYears(startExpression,endExpression) Gibt die Differenz von startExpression und endExpression (in Jahren) zurück.

Argumente

startExpression, endExpression: DateTime oder DateTimeOffset. Hinweis: startExpression und endExpression müssen vom selben Typ sein.

Rückgabewert

Int32.
GetTotalOffsetMinutes(datetimeoffset) Gibt die Anzahl von Minuten zurück, die datetimeoffset von GMT abweicht. Der Wert liegt im Allgemeinen zwischen +780 und -780 (+ oder - 13 Stunden). Hinweis: Diese Funktion wird nur in SQL Server 2008 unterstützt.

Argumente

einen DateTimeOffset

Rückgabewert

Int32.
Hour(expression) Gibt den Stundenteil von expression als Int32 zwischen 0 und 23 zurück.

Argumente

DateTime, Time und DateTimeOffset.

Beispiel

-- The following example returns 22.

Hour(cast('22:35:5' as DateTime))
Millisecond(expression) Gibt den Millisekundenteil von expression als Int32 zwischen 0 und 999 zurück.

Argumente

DateTime, Time und DateTimeOffset.

Rückgabewert

Int32.
Minute(expression) Gibt den Minutenteil von expression als Int32 zwischen 0 und 59 zurück.

Argumente

DateTime, Time oder DateTimeOffset.

Rückgabewert

Int32.

Beispiel

-- The following example returns 35

Minute(cast('22:35:5' as DateTime))
Month(expression) Gibt den Monatsteil von expression als Int32 zwischen 1 und 12 zurück.

Argumente

DateTime oder DateTimeOffset.

Rückgabewert

Int32.

Beispiel

-- The following example returns 3.

Month(cast('03/12/1998' as DateTime))
Second(expression) Gibt den Sekundenteil von expression als Int32 zwischen 0 und 59 zurück.

Argumente

DateTime, Time und DateTimeOffset.

Rückgabewert

Int32.

Beispiel

-- The following example returns 5

Second(cast('22:35:5' as DateTime))
TruncateTime(expression) Gibt expression mit abgeschnittenen Zeitwerten zurück.

Argumente

DateTime oder DateTimeOffset.

Rückgabewert

Der expression-Typ.
Year(expression) Gibt den Jahresteil von expression als Int32 YYYY zurück.

Argumente

DateTime und DateTimeOffset.

Rückgabewert

Int32.

Beispiel

-- The following example returns 1998.

Year(cast('03/12/1998' as DateTime))

Diese Funktionen geben null zurück, wenn die Eingabe null ist.

Entsprechende Funktionen sind für den verwalteten Anbieter des Microsoft SQL-Clients verfügbar. Weitere Informationen finden Sie unter SqlClient für Entity Framework-Funktionen.

Siehe auch