HOURS-Funktion [Datum und Uhrzeit]

Bearbeitet einen TIMESTAMP-Wert oder gibt die Anzahl von Stunden zwischen zwei TIMESTAMP-Werten zurück. 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

Zeit-_oder_Zeitstempelausdruck Ein Wert vom Typ TIME oder TIMESTAMP.
Zeitstempelausdruck Ein Wert vom Typ TIMESTAMP.
Ganzzahlausdruck Die Anzahl der Stunden, die zu Zeit-_oder_Zeitstempelausdruck addiert werden sollen. Wenn Ganzzahlausdruck negativ ist, wird die entsprechende Anzahl an Stunden von Zeit-_oder_Zeitstempelausdruck abgezogen.
Hinweise zum Casting von Datentypen finden Sie unter CAST-Funktion [Datentypkonvertierung].

Bemerkungen

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

Syntax 1 Wenn Sie einen einzelnen Zeitstempelausdruck an die HOURS-Funktion übergeben, wird die Anzahl der Stunden zwischen Mitternacht am 0000-02-29 und Zeitstempelausdruck als INTEGER-Wert 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 einen INTEGER-Wert an die HOURS-Funktion übergeben, liefert die Funktion das TIMESTAMP-Ergebnis nach dem Addieren der durch die Ganzzahl ausgedrückten Anzahl an Stunden zum Zeit-_oder_Zeitstempelausdruck-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 gibt den Wert 17517342 zurück:

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

Die folgenden Anweisungen geben den DATETIME-Wert 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.

HOURS-Funktion [Datum und Uhrzeit]

Syntax 1

Syntax 2

Syntax 3

Parameter

Rückgabe

Bemerkungen

Hinweis

Siehe auch

Beispiel