Lade...
 

CX_SPAN_TIME - Zeitspanne

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.  

Operatoren
Operator Kurzbeschreibung
+, - Arithmetik
>, <, = Vergleiche
Methodenverzeichnis (MDI)
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

Daten Verzeichnis (DDI)
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

Verwendung in AppsWH
Modul Kurzbeschreibung