Freigeben über


Kanonische Datums- und Uhrzeitfunktionen (Entity SQL)

Entity SQL enthält kanonische Datums- und Uhrzeitfunktionen. 

Hinweise

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

Funktion Beschreibung

AddNanoseconds( expression, number)

Fügt dem expression den angegebenen number-Wert (in Nanosekunden) hinzu.

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der Typ des expression.

AddMicroseconds( expression, number)

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

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der Typ des expression.

AddMilliseconds( expression, number)

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

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der Typ des expression.

AddSeconds( expression, number)

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

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der Typ des expression.

AddMinutes( expression, number)

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

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der Typ des expression.

AddHours( expression, number)

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

Argumente

expression, DateTime, DateTimeOffset oder Time.

number: Int32.

Rückgabewert

Der Typ des expression.

AddDays( expression, number)

Fügt am Ende der expression den angegebenen number-Wert für die Tage hinzu.

Argumente

expression: DateTime oder DateTimeOffset.

number: Int32.

Rückgabewert

Der Typ des expression.

AddMonths( expression, number)

Fügt dem expression den angegebenen number-Wert für die Monate hinzu.

Argumente

expression: DateTime oder DateTimeOffset.

number: Int32.

Rückgabewert

Der Typ des expression.

AddYears( expression, number)

Fügt dem expression den angegebenen number-Wert für die Jahre hinzu.

Argumente

expression: DateTime oder DateTimeOffset.

number: Int32.

Rückgabewert

Der Typ des expression.

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

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

DateTimeOffset

CreateTime( hour, minute, second)

Gibt einen neuen Time-Wert als aktuelle Zeit zurück.

Argumente

hour und minute: Int32

second: Double.

Rückgabewert

Time

CurrentDateTime()

Gibt das aktuelle Datum und die aktuelle Zeit des Servers in der Zeitzone des Servers als DateTime-Wert zurück.

Rückgabewert

DateTime

CurrentDateTimeOffset()

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

Rückgabewert

DateTimeOffset

CurrentUtcDateTime()

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

Rückgabewert

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.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffMilliseconds( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffMicroseconds( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffSeconds( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffMinutes( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffHours( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime, DateTimeOffset oder Time.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffDays( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime oder DateTimeOffset.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffMonths( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime oder DateTimeOffset.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

DiffYears( startExpression, endExpression)

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

Argumente

startExpression, endExpression: DateTime oder DateTimeOffset.

Bb738563.note(de-de,VS.100).gifHinweis:
startExpression und endExpression müssen den gleichen Typ aufweisen.

Rückgabewert

Int32

GetTotalOffsetMinutes( datetimeoffset )

Gibt die Anzahl von Minuten zurück, die datetimeoffset von GMT abweicht. Dieser Wert beträgt im Allgemeinen zwischen +780 und -780 (+13 Stunden bzw. -13 Stunden).

Bb738563.note(de-de,VS.100).gifHinweis:
Diese Funktion wird nur in SQL Server 2008 unterstützt.

Argumente

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

Ein 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

Ein Int32.

Beispiel

-- The following example returns 5

Second(cast('22:35:5' as DateTime))

Truncate( expression )

Gibt den expression mit abgeschnittenen Zeitwerten zurück.

Argumente

DateTime oder DateTimeOffset.

Rückgabewert

Der Typ des expression.

Year( expression )

Gibt den Jahresteil von expression als Int32YYYY 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 beträgt.

Eine entsprechende Funktion ist für den verwalteten Anbieter des Microsoft SQL-Clients verfügbar. Weitere Informationen finden Sie unter .NET Framework-Datenanbieter für SQL Server (SqlClient) für die Entity Framework-Funktionen.

Siehe auch

Konzepte

Kanonische Funktionen (Entity SQL)