%NextTime function

Old name

%NextTimeT

Function

The function returns the value of the following timestamp which is newer than the current time. The timestamp value is given by the period Period and by the time offset Offset, that are given in seconds. Result is absolute time.

Declaration

TIME %NextTime(
   INT in Period, 
   INT in Offset, 
   UNIVAL in CalcTrigger,
   TEXT in timeZone := %GetCurrentTimeZone()
 )

Parameters

period	Period [s] - must be a positive value.
offset	Offset [s] - may be a negative value, too.
CalcTrigger	An object, whose change recalculates the function. Its type is arbitrary. The trigger is used only for eval tags and is ignored in ESL scripts. Note: This parameter was implemented when there were no eval tags with triggers. If a tag is to be evaluated when a particular object changes, use an eval tag with a trigger.
timeZone

Example

%NextTime, %SubTime - time interval generation