NEXT_WEEK Skalarfunktion

Die Funktion NEXT_WEEK gibt den ersten Tag der nächsten Woche nach dem angegebenen Datum zurück. Sonntag wird als erster Tag dieser neuen Woche betrachtet.

Read syntax diagramSkip visual syntax diagramNEXT_WEEK(datetime-expression )

Das Schema ist SYSIBM.

datetime-Ausdruck
Ein Ausdruck, der ein Datum angibt, nach dem der erste Tag der nächsten Woche zurückgegeben werden soll. Der Ausdruck muss einen Wert zurückgeben, der ein DATE-, TIMESTAMP-, CHAR-oder VARCHAR-Datentyp ist. In einer Unicode-Datenbank kann der Ausdruck auch ein Datentyp GRAPHIC oder VARGRAPHIC sein. CHAR, VARCHAR, GRAPHIC und VARGRAPHIC werden mit impliziter Umsetzung unterstützt. Wenn datetime-expression ein Datentyp CHAR, VARCHAR, GRAPHIC oder VARGRAPHIC ist, muss es sich um eine gültige Zeichenfolge handeln, die von der Skalarfunktion TIMESTAMP akzeptiert wird.

Das Ergebnis der Funktion ist DATE. Wenn das Argument null sein kann, kann das Ergebnis null sein. Wenn das Argument null ist, ist das Ergebnis der Nullwert.

Beispiel

Das folgende Beispiel gibt den Datumswert des ersten Tages der nächsten Woche nach dem durch die Eingabe angegebenen Datum zurück:
values next_week('2007-02-18')
      Result: 2007-02-25