ADD_TIME

Use the ADD_TIME script function to add two times. The script function returns the result of the addition, in the time format that you specify. The calculation takes the change from 23:59:59 to 00:00:00 into account.

Syntax

ADD_TIME ([Time Format;]Time1, [Time Format;]Time2 [,Output Format])

Parameters

  • ADD_TIME
    Adds two times

  • Time Format
    (Optional) Specify a format followed by a semicolon separator (;)
    More Information: Date, Time and Period Formats in Scripts

  • Time1, Time2
    Times to add, in HHMMSS format
    Format: script literal or script variable

  • Output Format
    (Optional) time format for the time that the script function returns
    Format: AE name, script literal or script variable
    Default: HHMMSS

Examples

The following example adds two times without specifying a time format. The script prints the result (130000) in the activation report.

:SET &TIME# = ADD_TIME("120000","010000")
:
PRINT &TIME#

The following example specifies time formats for one of the times and for the output. The script prints the result (04:59) in the activation report.

:SET &TIME# = ADD_TIME("235959", "HH;05", "HH:MM")
:
PRINT &TIME#

The following example adds 71 seconds to 23:59:59. The script specifies the time formats for both times given, but not for the output. The script prints the result (000110) in the default format.

:SET &TIME# = ADD_TIME("HH:MM:SS;23:59:59", "SS;71")
:
PRINT &TIME#

The following example also adds 71 seconds to 23:59:59. The script specifies a format that only includes the seconds for the output. The script prints the result (70) in the activation report.

:SET &TIME# = ADD_TIME("HHMMSS;235959", "SS;71", SS)
:
PRINT &TIME#

See also: