MINUTES-Funktion [Datum und Uhrzeit]

Die MINUTES-Funktion bearbeitet einen TIMESTAMP-Wert oder liefert die Anzahl von Minuten zwischen zwei TIMESTAMP-Werten. Weitere Hinweise finden Sie im folgenden Abschnitt "Bemerkungen".

Syntax 1

MINUTES( Zeitstempelausdruck )

Syntax 2

MINUTES( Zeitstempelausdruck, Zeitstempelausdruck )

Syntax 3

MINUTES( Zeitstempel- oder Zeitausdruck, Ganzzahlausdruck )

Parameter

Zeitstempelausdruck Ein Ausdruck vom Typ TIMESTAMP.
Zeitstempel- oder Zeitausdruck Ein Ausdruck vom Typ TIME oder TIMESTAMP.
Ganzzahlausdruck Die Anzahl von Minuten, die zu Zeitstempel- oder Zeitausdruck addiert werden soll. Wenn Ganzzahlausdruck negativ ist, wird die entsprechende Anzahl von Minuten von Zeitstempel- oder Zeitausdruck abgezogen.

Bemerkungen

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

Syntax 1 Wenn Sie einen einzelnen Zeitstempelausdruck an die MINUTES-Funktion übergeben, wird die Anzahl der Minuten zwischen Mitternacht am 0000-02-29 und Zeitstempelausdruck als Ganzzahl zurückgegeben.

Hinweis

"0000-02-29" gibt kein tatsächliches Datum wieder. Es ist das von der MINUTES-Funktion verwendete Standarddatum.
Syntax 2 Wenn Sie zwei TIMESTAMP-Werte an die MINUTES-Funktion übergeben, liefert die Funktion die als Ganzzahl ausgedrückte Anzahl der Minuten zwischen den beiden.
Syntax 3 Wenn Sie einen TIMESTAMP-Wert und eine Ganzzahl an die MINUTES-Funktion übergeben, liefert die Funktion das TIMESTAMP-Ergebnis nach dem Addieren der durch die Ganzzahl ausgedrückten Anzahl an Minuten zum Zeitstempelausdruck-Argument. Entsprechend ist, wenn das erste Argument für MINUTES ein TIME-Wert ist, das Ergebnis ebenfalls ein TIME-Wert. 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.

Da die MINUTES-Funktion eine Ganzzahl zurückgibt, kann es zu einem Überlauf kommen, wenn Syntax 1 mit TIMESTAMP-Werten ab 4083-03-23 02:08:00 benutzt wird.

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

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

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

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

Die folgende Anweisung liefert den Wert 1051040527.

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

Die folgenden Anweisungen geben den TIMESTAMP-Wert 1999-05-12 21:10:07.000 zurück. Beachten Sie, dass die ersten Anweisung eine explizite Typfestlegung des literalen Zeichenfolgenparameters erfordert. Es wird empfohlen, das zweite Beispiel zu verwenden (DATEADD).

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

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

Kommentieren Sie diese Seite in DocCommentXchange.

MINUTES-Funktion [Datum und Uhrzeit]

Syntax 1

Syntax 2

Syntax 3

Parameter

Rückgabe

Bemerkungen

Hinweis

Siehe auch

Standards und Kompatibilität

Beispiel