WEEKS( Zeitstempelausdruck )

WEEKS( Zeitstempelausdruck, Zeitstempelausdruck )

WEEKS( Zeitstempelausdruck, Ganzzahlausdruck )

INTEGER bei Syntax 1 und Syntax 2.

TIMESTAMP bei Syntax 3.

Wenn ein einzelnes Datum eingegeben wird (Syntax 1), liefert die WEEKS-Funktion die Anzahl der Wochen seit 0000-02-29.

Wenn zwei Daten eingegeben werden (Syntax 2), liefert die WEEKS-Funktion die Anzahl der Wochen zwischen den beiden Daten. Die WEEKS-Funktion ähnelt der DATEDIFF-Funktion, allerdings ist die Methode zur Berechnung der Anzahl der Wochen zwischen den Daten nicht identisch und kann ein anderes Ergebnis bringen. Der Rückgabewert für WEEKS wird festgelegt, indem die Anzahl von Tagen zwischen den beiden Daten durch 7 geteilt und abgerundet wird. DATEDIFF verwendet jedoch in seiner Berechnung die Anzahl der überschrittenen Wochengrenzen. Daher können die beiden Funktionen unterschiedliche Werte zurückgeben. Beispiel: Wenn das erste Datum ein Freitag ist und das zweite der nachfolgende Montag, gibt die WEEKS-Funktion den Unterschied 0 zurück, die DATEDIFF-Funktion dagegen den Unterschied 1. Obwohl keine Methode besser ist als die andere, sollten Sie den Unterschied im Auge behalten, wenn Sie sich für WEEKS oder DATEDIFF entscheiden.

Weitere Hinweise zur DATEDIFF-Funktion finden Sie unter DATEDIFF-Funktion [Datum und Uhrzeit].

Wenn ein Datum und eine Ganzzahl eingegeben werden (Syntax 3), addiert die WEEKS-Funktion die mit der Ganzzahl ausgedrückte Anzahl von Wochen zum angegebenen Zeitstempelausdruck-Wert. Bei Syntax 3, müssen Sie Zeitstempelausdruck explizit als Datentyp TIME, DATE oder TIMESTAMP festlegen. Wenn Zeitstempelausdruck ein TIME-Wert ist, wird das aktuelle Datum angenommen. Verwenden Sie statt Syntax 3 die DATEADD-Funktion.

Weitere Hinweise zur DATEADD-Funktion finden Sie unter DATEADD-Funktion [Datum und Uhrzeit].

Hinweise zur Konvertierung von Datentypen finden Sie unter CAST-Funktion [Datentypkonvertierung].

Die folgende Anweisung gibt den Wert 8 zurück. Das bedeutet, dass 2008-09-13 10:07:12 acht Wochen später ist als 2008-07-13 06:07:12.

SELECT WEEKS( '2008-07-13 06:07:12', '2008-09-13 10:07:12' );

Die folgende Anweisung gibt den Wert 104792 zurück. Das bedeutet, dass das Datum 104792 nach 0000-02-29 liegt.

SELECT WEEKS( '2008-07-13 06:07:12' );

Die folgende Anweisung gibt den TIMESTAMP-Wert 2008-06-16 21:05:07.0 zurück. Dies steht für das Datum und die Uhrzeit fünf Wochen nach 2008-05-12 21:05:07.

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