This class can be used to display a specific time. In the generation, the current system time gets adopted. A time specification is normally between 0 and 12 pm.
Screen display
InstantView® statement: DigitalTime
In connection with this interface object and specific InstantView® statements the particular flags belonging to the object play an important role, since it is possible to modify the object presentation/display with them.
Remark: A digital clock is available as the InstantView® statement DigitalTimer and an analog clock as the InstantView® statement AnalogTimer. At 12 o clock at night, both interface objects send the message MIDNIGHT. The following program shows the application of both interface objects.
The exemplary program adds five seconds to the time "12:11.10:09" and changes
it to "12:11.15:09".
Var(time)
CreateTransObject(TIME) -> time
"12:11.10:09" time PutData
5 time Call(AddSecond)
The exemplary program adds five minutes to the time
"12:11.10:09" and changes it to
"12:16.10:09".
Var(time)
CreateTransObject(TIME) -> time
"12:11.10:09" time PutData
5 time Call(AddMinute)
The exemplary program adds five hours to the time
"12:11.10:09" and changes the it to
"17:11.10:09".
Var(time)
CreateTransObject(TIME) -> time
"12:11.10:09" time PutData
5 time Call(AddHour)
| function | MA* | parameter | return | brief description |
|---|---|---|---|---|
| AddHundredthSecond | adding hundredths of a second | |||
| AddSecond | adding seconds | |||
| AddMinute | adding minutes | |||
| AddHour | adding hours | |||
| DayTime | STRING | Tageszeit der Uhrzeit | ||
| Duration | OBJECT | returning the duration | ||
| Encompassed | (OBJECT) | INTEGER | "included-in" test | |
| EndOfPeriod | OBJECT | calculating end | ||
| ExportTimeNumber | (INTEGER) | STRING | export time as a string | |
| HourOfTime | INTEGER | Stundenanteil der Zeit | ||
| HundredthSecondOfTime | INTEGER | Hundertstel-Sekundenanteil der Zeit | ||
| ImportTimeNumber | (STRING, INTEGER) | importing time as a string | ||
| JoinPeriods | (OBJECT) | VOLATILE_OBJECT | joining two passed time spans into one | |
| MinuteOfTime | INTEGER | Minutenanteil der Zeit | ||
| MLDayTime | MLSTRING | multilingual Mehrsprachige Tageszeit der Uhrzeit | ||
| NextTerm | (OBJECT) | OBJECT | der Zeitpunkt innerhalb des Zeitpunktes | |
| Overlap | (OBJECT) | INTEGER | overlap test | |
| OverlappingPeriod | (OBJECT) | VOLATILE_OBJECT | calculating the intersection (disjunction) of two time spans | |
| PeriodicRefreshOfTime | (INTEGER) | time synchronisation | ||
| RealEndOfPeriod | OBJECT | calculating the "real" end | ||
| RealStartOfPeriod | OBJECT | calculating the real start | ||
| SecondOfTime | INTEGER | Sekundenanteil der Zeit | ||
| SetHour | (INTEGER) | setting a new hour | ||
| SetHundredthSecond | (INTEGER) | setting a new hundredth of a second | ||
| SetMinute | (INTEGER) | setting a new minute | ||
| SetSecond | (INTEGER) | setting a new second | ||
| SetZero | ||||
| StartOfPeriod | OBJECT | calculating start | ||
| ValueInMinutes | INTEGER | time in minutes | ||
| ValueInSeconds | INTEGER | time in seconds | ||
| ValueOfTime | INTEGER | time in hundredths of a second | ||
| string | INTEGER | CX_STRING | provides the string display of the object |
| data field | type | reference class | I* | brief description |
|---|---|---|---|---|
| this | CX_TIME | time |
| module | brief description |
|---|---|