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
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
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 | 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 |