Lade...
 

CX_DATE::Next

CX_DATE::Next

Beschreibung:

Diese Funktion ermittelt den Tag, der zu dem übergebenen Wochentag gehört und mindestens 1, maximal 7 Tage hinter dem Tag des Datumsobjekt liegt.
Liegt also das Datumsobjekt bereits auf dem übergebenen Wochentag, so wird

genau eine Woche nach vorne gegangen.

Wir erhalten also ein Ergebnis, das einer saloppen Beschreibung wie "nächsten (diesen)

Mittwoch" entspricht.

Der Wochentag wird als Konstante übergeben, wie sie u.a. von der Funktion DayOfWeek benutzt werden. Siehe hierzu die Wochentag-Tabelle.
Für eine Datumsperiode bezieht sich diese Funktion

auf ihr Startdatum.

Code-Beispiel:

In dem Beispiel-Programm wird der nächste Montag nach dem "3.10.1990"

ermittelt, wobei der Montag durch eine "0" repräsentiert wird. 

Var(date)   CreateTransObject(CX_DATE) -> date   // Objekt erzeugen

"3.10.1990" date Put                             // Den Wert setzen
0 date Call(Next)                                // Hole den nächsten Montag (Konstante: 0)

Als Ergebnis erhält man das Tagesdatum "8.10.1990".

Stack
Stack Position Objekttyp Kurzbeschreibung
Stack(In) Top CX_DATE oder CX_SPAN_DATE das Datum(-sobjekt)
Top-1 INTEGER die Nummer des Wochentages
Stack(Out) Top CX_DATE der gesuchte Wochentag
Funktionsaufruf: Call(Next)