Time Increment

The *TIME INCREMENT built-in function lets you add a quantity to a given time. It is the converse of the *ELAPSED TIME built-in function.

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

*Time1 = *Time2 + *Elapsed Time

There are four parameters for this function type:

Three input parameters
- *Time2 specifies the beginning time. If it is of type NBR, it is interpreted as the elapsed time since 0 am.
- *Elapsed time specifies the quantity to be added to *Time2.
- *Time unit specifies the meaning of the *Elapsed time input parameter. Refer to the table at the end of this description.
One output parameter, *Time1, specifies the ending time. If it is of type NBR, it is interpreted as the elapsed time since 0 am.
The number of hours in the sum is factored by 24 to produce an integer from 0 to 23. In other words, if the number of hours is 24 or greater, the hours are divided by 24. The final number of hours in the *Time1 parameter is the remainder of the division. For example, if the sum is 64 hours and 32 minutes, the result in *Time1 is 16 hours and 32 minutes (64/24=2 + a remainder of 16).

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

*Time Unit Values	Effect on the *Elapsed Time Parameter
*SECONDS	An integer specifying the number of seconds to add to the specified time (*Time2).
*MINUTES	An integer specifying the number of minutes to add to the specified time (*Time2).
*HOURS	An integer specifying the number of hours to add to the specified time (*Time2).
*HHMM	The number of hours and minutes, in HHMM format, to add to the specified time (*Time2).
*HHMMSS	The number of hours, minutes, and seconds, in HHMMSS format, to add to the specified time (*Time2