This class is used for the display of a specific time span, which consists of a time and a duration. In the generation, the current system time gets taken as the start time. Usually, the start time is between 0.00 and 24.00 Uhr. At first, the duration will be "0 hours", whereas for the time-duration-display it is possible to choose different units, such as seconds or minutes.
1. "9.20"
2. "9.20 - 9.50"
3. "Ab 9.20"
4. "Bis 9.20"
1. Application of an interface object of the type string. In this case, the object is specified in one single input field. The following image shows an example (program code):
Remark: Entering a time span, start and end time are separated by the one of the following characters: '-', '·' or '/'.
2. The application of two interface objects of the type DigitalTime. The start time gets entered in one and the end time in the other object (program code). It ineeds to be considered, that without additional interface objects, it is only possible to administer time spans with a defined start and end time, meaning specifications such as "ab 10.00 Uhr" are not possible.
3. The application of the interface objects DigitalTime and String. The first one specifies the start time and the second one the duration (program code). It needs to be considered, that without additional interface objects, it is only possible to administer interface objects with a defined start- and end time, meaning specifications such as "ab 10.00 Uhr" are not possible.
In context with these display options and specific InstantView® statements, the flags that belong to this object play an important role, since they can be used to modify the object display .
| function | MA* | parameter | return | brief description |
|---|---|---|---|---|
| MovePeriodToEndTime | (OBJECT) | setting the end time without changing the period | ||
| MovePeriodToStartTime | (OBJECT) | setting the start time without changing the period | ||
| NextTerm | (OBJECT) | OBJECT | der Zeitpunkt innerhalb des Zeitpunktes | |
| SetDuration | (OBJECT) | setting the duration | ||
| SetEndOfPeriod | (OBJECT) | setting the end time and changing the period | ||
| SetPeriodBorders | (OBJECT, OBJECT) | setting start and end time | ||
| SetStartOfPeriod | (OBJECT) | setting start time and changing the period | ||
| AddHundredthSecond | hundredths of a second addition | |||
| AddSecond | second addition | |||
| AddMinute | minute addition | |||
| AddHour | hour addtition | |||
| DayTime | STRING | time of day Tageszeit des Zeitpunktes | ||
| Duration | OBJECT | duration return | ||
| Encompassed | (OBJECT) | INTEGER | "Enthalten in"-Test | |
| EndOfPeriod | OBJECT | calculating the end time | ||
| ExportTimeNumber | (INTEGER) | STRING | exporting time as a string | |
| HourOfTime | INTEGER | hour fraction of the time | ||
| HundredthSecondOfTime | INTEGER | hundredth of a second fraction of the time | ||
| ImportTimeNumber | (STRING, INTEGER) | importing time specification | ||
| JoinPeriods | (OBJECT) | VOLATILE_OBJECT | joining two passed time spans | |
| MinuteOfTime | INTEGER | minute fraction of the time | ||
| MLDayTime | MLSTRING | multilingual Mehrsprachige Tageszeit 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 time | ||
| RealStartOfPeriod | OBJECT | calculating "real" start time | ||
| SecondOfTime | INTEGER | second fraction of the time | ||
| 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 the start time | ||
| string | INTEGER | CX_STRING | provides the string display of an object | |
| ValueInMinutes | INTEGER | start time in minutes | ||
| ValueInSeconds | INTEGER | start time in seconds | ||
| ValueOfTime | INTEGER | start time in hundredths of a second |
| data field | type | reference class | I* | brief description |
|---|---|---|---|---|
| this | CX_TIME | Der Basiszeitpunkt. | ||
| duration | CX_VALUE | the actual period; if this value is "0", a time gets displayed; moreover, negative periods are allowed, too | ||
| validEnum | INTEGER | the time span type: "0" = time span with start and end; "1" = start, but there is no end; "2" = end, but there is no start; "3" = infinite time period without start or end |
| module | brief description |
|---|---|