HOURS-Funktion [Datum und Uhrzeit]

Die HOURS-Funktion bearbeitet einen TIMESTAMP-Wert oder liefert die Anzahl von Stunden zwischen zwei TIMESTAMP-Werten. Spezifische Details finden Sie unter dem Verwendungszweck dieser Funktion.

Syntax 1

HOURS ( timestamp-expression )

Syntax 2

HOURS ( timestamp-expression, timestamp-expression )

Syntax 3

HOURS ( time-or-timestamp-expression, integer-expression )

Parameter

time-or-timestamp-expression Ein Wert vom Typ TIME oder TIMESTAMP.
timestamp-expression Ein Wert vom Typ TIMESTAMP.
integer-expression Die Anzahl der Stunden, die zu time-or-timestamp-expression zu addieren ist. Wenn integer-expression negativ ist, wird die entsprechende Anzahl an Stunden von time-or-timestamp-expression abgezogen.
Hinweise zur Konvertierung von Datentypen finden Sie unter CAST-Funktion [Datentypkonvertierung].

Bemerkungen

Das Ergebnis der HOURS-Funktion hängt von deren Argumenten ab.

Syntax 1 Wenn Sie ein einzelnes timestamp-expression-Argument an die HOURS-Funktion übergeben, wird die Anzahl der Stunden zwischen 0000-02-29 und timestamp-expression als Ganzzahl zurückgegeben.

Hinweis

"0000-02-29" gibt kein tatsächliches Datum wieder. Es ist der von der HOURS-Funktion standardmäßig verwendete TIMESTAMP-Wert.
Syntax 2 Wenn Sie zwei TIMESTAMP-Werte an die HOURS-Funktion übergeben, liefert die Funktion die als Ganzzahl ausgedrückte Anzahl der Stunden zwischen den beiden.
Syntax 3 Wenn Sie einen TIMESTAMP-Wert und eine Ganzzahl an die HOURS-Funktion übergeben, liefert die Funktion das TIMESTAMP-Ergebnis nach dem Addieren der durch die Ganzzahl ausgedrückten Anzahl an Stunden zum time-or-timestamp-expression-Argument. Wenn Sie einen TIME-Wert als erstes Argument übergeben, wird entsprechend ein TIME-Wert als Ergebnis zurückgegeben. Syntax 3 unterstützt keine implizite Konvertierung des ersten Arguments. Es kann erforderlich sein, das erste Argument explizit in einen DATE-, TIME- oder TIMESTAMP-Wert zu konvertieren. Wenn das erste Argument ein DATE-Wert ist, wird Mitternacht für die Zeitangabe angenommen.

Verwenden Sie statt Syntax 2 die DATEDIFF-Funktion. Verwenden Sie statt Syntax 3 die DATEADD-Funktion.

Die folgenden Anweisungen geben den Wert "4" zurück, womit angezeigt wird, dass der zweite TIMESTAMP-Wert vier Stunden nach dem ersten liegt. Es wird empfohlen, das zweite Beispiel zu verwenden (DATEDIFF).

SELECT HOURS( '1999-07-13 06:07:12', '1999-07-13 10:07:12' );

SELECT DATEDIFF( hour, '1999-07-13 06:07:12', '1999-07-13 10:07:12' );

Die folgende Anweisung liefert den Wert 17517342.

SELECT HOURS( '1998-07-13 06:07:12' );

Die folgenden Anweisungen geben den Datums- und Uhrzeitwert 1999-05-13 02:05:07.000 zurück. Es wird empfohlen, dass Sie das zweite Beispiel (DATEADD) verwenden.

SELECT HOURS( CAST( '1999-05-12 21:05:07' AS DATETIME ), 5 );

SELECT DATEADD( hour, 5, '1999-05-12 21:05:07' );

Kommentieren Sie diese Seite in DocCommentXchange.