SECONDS-Funktion [Datum und Uhrzeit]

Bearbeitet einen TIMESTAMP-Wert oder gibt die Anzahl von Sekunden zwischen zwei TIMESTAMP-Werten zurück. Weitere Hinweise finden Sie im folgenden Abschnitt "Bemerkungen".

Syntax 1

SECONDS( timestamp-expression )

Syntax 2

SECONDS( timestamp-expression, timestamp-expression )

Syntax 3

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

Parameter

Zeitstempelausdruck Ein TIMESTAMP-Wert.
Zeit-_oder_Zeitstempelausdruck Ein Wert vom Typ TIME oder TIMESTAMP.
Ganzzahlausdruck Die Anzahl der Sekunden, die zu Zeit-_oder_Zeitstempelausdruck addiert werden sollen. Wenn Ganzzahlausdruck negativ ist, wird die entsprechende Anzahl an Sekunden von Zeit-_oder_Zeitstempelausdruck abgezogen. Wenn Sie einen Ganzzahlausdruck angeben, muss Zeitstempelausdruck explizit als Datentyp TIME, DATE oder TIMESTAMP festgelegt sein. Wenn Zeit-_oder_Zeitstempelausdruck vom Typ DATE ist, wird die Zeitangabe als Mitternacht angenommen.

Rückgabe

Bemerkungen

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

Syntax 1 Wenn Sie einen einzelnen Zeitstempelausdruck an die SECONDS-Funktion übergeben, wird die Anzahl der Sekunden zwischen Mitternacht am 0000-02-29 und Zeitstempelausdruck als UNSIGNED BIGINT-Wert zurückgegeben.

Hinweis

"0000-02" gibt kein tatsächliches Datum wieder. Es ist das von der SECONDS-Funktion verwendete Standarddatum.
Syntax 2 Wenn Sie zwei TIMESTAMP-Werte an die SECONDS-Funktion übergeben, liefert die Funktion die als Ganzzahl ausgedrückte Anzahl der Sekunden zwischen den beiden.
Syntax 3 Wenn Sie einen TIMESTAMP-Wert und eine Ganzzahl an die SECONDS-Funktion übergeben, liefert die Funktion das TIMESTAMP-Ergebnis nach dem Addieren der durch die Ganzzahl ausgedrückten Anzahl an Sekunden zum Zeit- oder Zeitstempelausdruck-Argument. Wenn Sie einen TIME-Wert an die SECONDS-Funktion übergeben, liefert die Funktion entsprechend einen Wert vom Typ TIME.

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

Siehe auch

Beispiel

Die folgenden Anweisungen geben den Wert "14400" zurück, womit angezeigt wird, dass der zweite TIMESTAMP-Wert 14400 Sekunden nach dem ersten liegt.

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

Die folgende Anweisung liefert den Wert 63062431632.

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

Die folgenden Anweisungen geben den TIMESTAMP-Wert "1999-05-12 21:05:12.000" zurück.

SELECT SECONDS( CAST( '1999-05-12 21:05:07' AS TIMESTAMP ), 5);
SELECT DATEADD( second, 5, '1999-05-12 21:05:07' );

Kommentieren Sie diese Seite in DocCommentXchange.