CX_SPAN_TIME
Klassenhierarchie
Beschreibung:
Mit dieser Klasse wird ein bestimmte Zeitspanne, die aus einem Zeitpunkt und einer Dauer besteht, abgebildet. Bei der Generierung wird für den Startzeitpunkt die aktuelle Systemzeit übernommen. Dabei liegt ein Startzeitpunkt im Normalfall zwischen 0.00 und 24.00 Uhr. Die Dauer beträgt zunächst "0 Stunden", wobei zur Zeitdauer-Darstellung verschiedene Einheiten, wie z.B. Sekunden oder Minuten, gewählt werden können.
Code-Beispiel:
1. "9.20"
2. "9.20 - 9.50"
3. "Ab 9.20"
4. "Bis 9.20"
Darstellung am Bildschirm
1. Verwendung eines Oberflächenobjektes vom Typ String. In diesem Fall wird das Objekt in einem einzigen Eingabefeld angegeben. Die folgende Abbildung zeigt ein Beispiel (Programmcode):
Anmerkung: Bei der Eingabe einer Zeitspanne werden der Start- und Endzeitpunkt durch eines der folgenden Zeichen getrennt: '-' oder '/'.
2. Die Verwendung von zwei Oberflächenobjekten vom Typ DigitalTime, wobei in dem einen Feld der Start- und in dem anderen der Endzeitpunkt eingegeben wird (Programmcode). Dabei ist zu beachten, dass ohne zusätzliche Oberflächenobjekte nur Zeitspannen mit definiertem Start- und Endzeitpunkt verwaltet werden können, d.h. Angaben wie "ab 10.00 Uhr" sind nicht möglich.
3. Die Verwendung der Oberflächenobjekte DigitalTime und String, wobei ersteres den Startzeitpunkt und das zweite die Zeitdauer angibt (Programmcode). Dabei ist zu beachten, dass ohne zusätzliche Oberflächenobjekte nur Zeitspannen mit definiertem Start- und Endzeitpunkt verwaltet werden können, d.h. Angaben wie "ab 10.00 Uhr" sind nicht möglich.
Im Zusammenhang mit diesen Darstellungsmöglichkeiten und bestimmten InstantView®- Anweisungen spielen die zum Objekt gehörigen Flags eine wichtige Rolle, da mit Ihnen die Darstellung des Objektes modifiziert werden kann.
Funktion | MA* | Parameter | Rückgabe | Kurzbeschreibung |
---|---|---|---|---|
MovePeriodToEndTime | OBJECT | Setzen der Endzeit ohne Verändern der Periode | ||
MovePeriodToStartTime | OBJECT | Setzen der Startzeit ohne Verändern der Periode | ||
NextTerm | OBJECT | OBJECT | der Zeitpunkt innerhalb des Zeitpunktes | |
SetDuration | OBJECT | Setzen der Zeitdauer | ||
SetEndOfPeriod | OBJECT | Setzen der Endzeit mit Verändern der Periode | ||
SetPeriodBorders | OBJECT, OBJECT | Setzen der Start- und Endzeit | ||
SetSpanTime 231532 |
STRING, INTEGER | Zeitspanne aus der übergebenen Zeichenkette importieren | ||
SetStartOfPeriod | OBJECT | Setzen der Startzeit mit Verändern der Periode | ||
AddHundredthSecond | Hundertstel-Sekunden-Addition | |||
AddSecond | Sekunden-Addition | |||
AddMinute | Minuten-Addition | |||
AddHour | Stunden-Addition | |||
DayTime | STRING | Tageszeit des Zeitpunktes | ||
Duration | OBJECT | Rückgabe der Zeitdauer | ||
Encompassed | OBJECT | INTEGER | "Enthalten in"-Test | |
EndOfPeriod | OBJECT | Endzeitpunkt berechnen | ||
ExportTimeNumber | INTEGER | STRING | Export der Zeit als String | |
HourOfTime | INTEGER | Stundenanteil der Zeit | ||
HundredthSecondOfTime | INTEGER | Hunderstel-Sekundenanteil der Zeit | ||
ImportTimeNumber | STRING, INTEGER | Zeitangabe importieren | ||
JoinPeriods | OBJECT | OBJECT | zwei übergebene Zeitspannen zu einer verbinden | |
MinuteOfTime | INTEGER | Minutenanteil der Zeit | ||
MLDayTime | ML_STRING | Mehrsprachige Tageszeit des Zeitpunktes | ||
Overlap | OBJECT | INTEGER | Überlappungstest | |
OverlappingPeriod | OBJECT | OBJECT | die Schnittmenge (Disjunktion) zweier Zeitspannen berechnen | |
RealEndOfPeriod | OBJECT | "echten" Endzeitpunkt berechnen | ||
RealStartOfPeriod | OBJECT | "echten" Startzeitpunkt berechnen | ||
SecondOfTime | INTEGER | Sekundenanteil der Zeit | ||
SetHour | INTEGER | Setzen einer neuen Stunde | ||
SetHundredthSecond | INTEGER | Setzen einer neuen Hundertstel-Sekunde | ||
SetMinute | INTEGER | Setzen einer neuen Minute | ||
SetSecond | INTEGER | Setzen einer neuen Sekunde | ||
SetTime 231532 |
STRING, INTEGER | Basiszeitpunkt aus der übergebenen Zeichenkette importieren | ||
SetZero | ||||
StartOfPeriod | OBJECT | Startzeitpunkt berechnen | ||
string | INTEGER | CX_STRING | Liefert die String-Darstellung des Objektes | |
ValueInMinutes | INTEGER | Startzeit in Minuten | ||
ValueInSeconds | INTEGER | Startzeit in Sekunden | ||
ValueOfTime | INTEGER | Startzeit in hundertstel Sekunden |
* MA = Member-Access-Funktion
Datenfeld | Typ | Referenz-Klasse | I* | Kurzbeschreibung |
---|---|---|---|---|
this | CX_TIME | Der Basiszeitpunkt. | ||
duration | CX_VALUE | Die eigentliche Periode. Ist dieser Wert gleich "0", so wird ein Zeitpunkt abgebildet. Des weiteren sind auch negative Perioden erlaubt. | ||
validEnum | INTEGER | Der Typ der Zeitspanne: "0" = eine Zeitspanne mit Start und Ende; "1"= Start, aber es existiert kein Ende; "2" = Ende, aber es existiert kein Start; "3" = unendlicher Zeitraum ohne Start und Ende. |
* I = Indizierbares Datenfeld
Modul | Kurzbeschreibung |
---|---|