%NextTime function


Old name
%NextTimeT
Function

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

Declaration

TIME %NextTime(
   INT in Period, 
   INT in Offset, 
   UNIVAL in CalcTrigger,
   INT in timeZone :=  %GetTimeZone()
 )
Parameters
periodPeriod [s] - must be a positive value.
offsetOffset [s] - may be a negative value, too.
CalcTriggerAn object, which change recalculates the function. Its type is arbitrary. Trigger is used only when in eval tags and 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 trigger.
timeZoneForced time zone to convert to a local time. It is set as a time zone offset from UTC during winter in seconds.
Napíšte komentár