Elapsed Time

Modifying Action Diagrams › Understanding Built-In Functions › Selection Parameters for Date Built-In Functions › Elapsed Time

Elapsed Time

The *ELAPSED TIME built-in function calculates the elapsed time between a beginning time and an ending time. It is the converse of the *TIME INCREMENT built-in function.

The *ELAPSED TIME built-in function performs the operation:

*Elapsed Time = *Time1 - *Time2

The result is positive if *Time1 is after *Time2; it is negative if *Time1 is before *Time2.

There are four parameters for this function type:

Three input parameters
- *Time2 and *Time1 specify the beginning and ending times, respectively. When either time is of type NBR, it is interpreted as the elapsed time since 0 a.m.
- *Time unit specifies the meaning of the *Elapsed time output parameter.
One output parameter, *Elapsed time. The meaning of this parameter is determined by the value of *Time unit.

The valid values for *Time unit and the effect each has on the meaning of *Elapsed time are shown in the following table.

*Time Unit Values	Effect on the *Elapsed Time Parameter
*SECONDS	The result is given as an integer specifying the number of elapsed seconds.
*MINUTES	The result is given as the number of elapsed minutes; partial minutes are ignored.
*HOURS	The result is given as the number of elapsed hours; partial hours are ignored.
*HHMM	The result is given as the number of elapsed hours and minutes in HHMM format.
*HHMMSS	The result is given as the number of elapsed hours, minutes, and seconds in HHMMSS format.