CX_TIME
Klassenhierarchie
Beschreibung:
Mit dieser Klasse wird eine bestimmte Uhrzeit abgebildet. Bei der Generierung wird die aktuelle Systemzeit übernommen. Dabei liegt eine Uhrzeit im Normalfall zwischen 0.00 und 24.00 Uhr.
Darstellung am Bildschirm
InstantView® Anweisung: DigitalTime
Im Zusammenhang mit diesem Oberflächenobjekt und bestimmten InstantView® Anweisungen spielen die zum Objekt gehörigen Flags eine wichtige Rolle, da mit Ihnen die Darstellung des Objektes modifiziert werden kann.
Hinweis: Mit den Funktionen AddHundredthSecond, AddSecond, AddMinute und AddHour sowie den Operatoren + und - ist es möglich Uhrzeiten zu erzeugen, die nach 24:00 Uhr liegen können. So lässt sich nachvollziehen, ob die Uhrzeit des Ergebnisses im selben Tag liegt (0:00 - 24:00 Uhr) wie die Ausgangsuhrzeit, oder in Tagen danach (Uhrzeiten größer als 24:00 Uhr)
Hinweis: Eine digitale Uhr ist als InstantView® Anweisung DigitalTimer, eine analoge Uhr als InstantView® Anweisung AnalogTimer verfügbar. Jedes dieser beiden Oberflächenobjekte sendet um 0.00 Uhr die Message MIDNIGHT aus. Das folgende Programm zeigt die Verwendung der beiden Oberflächenobjekte:
Code-Beispiel:
In dem Beispiel-Programm werden fünf Sekunden zu der Zeit "12:11.10:09" addiert, sodass sich die Uhrzeit zu "12:11.15:09" ändert.
Var(time)
CreateTransObject(TIME) -> time
"12:11.10:09" time Put
5 time Call(AddSecond)
In dem Beispiel-Programm werden fünf Minuten zu der Zeit "12:11.10:09" addiert, sodass sich die Uhrzeit zu "12:16.10:09" ändert.
Var(time)
CreateTransObject(TIME) -> time
"12:11.10:09" time Put
5 time Call(AddMinute)
In dem Beispiel-Programm werden fünf Stunden zu der Zeit "12:11.10:09" addiert, sodass sich die Uhrzeit zu "17:11.10:09" ändert.
Var(time)
CreateTransObject(TIME) -> time
"12:11.10:09" time Put
5 time Call(AddHour)
Funktion | MA* | Parameter | Rückgabe | Kurzbeschreibung |
---|---|---|---|---|
AddHundredthSecond | Hundertstel-Sekunden-Addition (vgl. Hinweis) | |||
AddSecond | Sekunden-Addition (vgl. Hinweis) | |||
AddMinute | Minuten-Addition (vgl. Hinweis) | |||
AddHour | Stunden-Addition (vgl. Hinweis) | |||
DayTime | STRING | Tageszeit der Uhrzeit | ||
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 | Hundertstel-Sekundenanteil der Zeit | ||
ImportTimeNumber | (STRING, INTEGER) | Import der Zeit als String | ||
JoinPeriods | (OBJECT) | VOLATILE_OBJECT | zwei übergebene Zeitspannen zu einer verbinden | |
MinuteOfTime | INTEGER | Minutenanteil der Zeit | ||
MLDayTime | MLSTRING | Mehrsprachige Tageszeit der Uhrzeit | ||
NextTerm | (OBJECT) | OBJECT | der Zeitpunkt innerhalb des Zeitpunktes | |
Overlap | (OBJECT) | INTEGER | Überlappungstest | |
OverlappingPeriod | (OBJECT) | VOLATILE_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 | Zeit aus der übergebenen Zeichenkette importieren | ||
SetZero | ||||
StartOfPeriod | OBJECT | Startzeitpunkt berechnen | ||
ValueInMinutes | INTEGER | Zeit in Minuten | ||
ValueInSeconds | INTEGER | Zeit in Sekunden | ||
ValueOfTime | INTEGER | Zeit in Hundertstel-Sekunden | ||
string | INTEGER | CX_STRING | Liefert die String-Darstellung des Objektes |
* MA = Member-Access-Funktion
Datenfeld | Typ | Referenz-Klasse | I* | Kurzbeschreibung |
---|---|---|---|---|
this | CX_TIME | Die Uhrzeit |
* I = Indizierbares Datenfeld
Modul | Kurzbeschreibung |
---|---|