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

Parameter	Description	Format	Default
Time Format	(Optional) Specify a format followed by a semicolon separator (;). More Information: Date, Time and Period Formats in Scripts	Script literal or script variable	n.a.
Time1, Time2	Times to add, in HHMMSS format.	Script literal or script variable	n.a.
Output Format	(Optional) Time format for the time that the script function returns.	AE name, script literal or script variable	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: