CX_DATE::SetDate
Beschreibung:
Diese Funktion importiert ein Datum, das als Zeichenkette vorliegt. Sie übernimmt die gleiche Funktion, die der InstantView®-Befehl Put zu Verfügung stellt, erlaubt aber, über Flags den Import zu steuern.
Folgende Flags sind definiert und können beliebig kombiniert werden:
Flag | Bedeutung |
---|---|
DF_ALLOW_INCOMPLETE_DATE | Verarbeitung eines unvollständigen Datums ist erlaubt, d.h. es können Angaben wie "5.7" (entspricht dem 5. Juli) gemacht werden. |
DF_ALLOW_ZERO_DATE | Verarbeitung eines vollständig undefinierten Datums, d.h. das Datum ist vollkommen unbekannt. Es wird entweder als Nichts ("") oder als unvollständiges Datum (?.?.?) eingegeben. |
197142
Das zu importierende Datum wird nur übernommen, wenn beim Import kein Fehler, z.B. Datum außerhalb der Limits, geworfen wird. Andernfalls bleibt der vorherige Wert im Datum und es wird keine Änderung durchgeführt.
Code-Beispiel:
Var(date)
CreateTransObject(CX_DATE) -> date
"5.7." 0 date Call(SetDate) // Fehler
"5.7.?" DF_ALLOW_INCOMPLETE_DATE date Call(SetDate) // 7. Juli mit undefiniertem Jahr
"?.?.?" 0 date Call(SetDate) // Fehler
"?.?.?" DF_ALLOW_INCOMPLETE_DATE date Call(SetDate) // vollständig undefiniertes Datum
"?.?.?" DF_ALLOW_ZERO_DATE date Call(SetDate) // vollständig undefiniertes Datum
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_DATE | Datum |
Top-1 | INTEGER | Flags | |
Top-2 | STRING | Datum im Klartext | |
Stack(Out) | Top |