%NextMonth function

Old name
%NextMonthT


Function

The function returns the starting time of the next month shifted by the offset given by the parameter Offset. Values of the parameter Offset may be negative, too. The result is a value of Absolute time type.

Declaration
TIME %NextMonth(
   INT in Offset, 
   UNIVAL in CalcTrigger,
   TEXT in timeZone := %GetCurrentTimeZone()
 )
Parameters
offsetOffset [s].
CalcTriggerObject - a change of its value causes the function to be recalculated. Its type is arbitrary.
timeZone

Name of the time zone used for conversion to local time (e.g. "Europe/London") or definition of fixed offset from UTC using format "(+|-)hh[:mi[:ss]]", where hh defines a number of hours, mi defines a number of minutes, and ss defines a number of seconds. Sign as well as a number of hours are mandatory parts of offset definition, number of minutes and seconds are optional and default to 0 (e.g. "+02:30" defines offset of 2 hours and 30 minutes from UTC). The empty text has the same meaning as function %GetCurrentTimeZone.
Note: For historical reasons, an integer parameter is also accepted. Its interpretation is as follows: 0 - zone "Europe/London", 3600 - zone "Europe/Bratislava", 7200 - zone "Europe/Kiev", 21600 - zone "Asia/Almaty". Usage of integer parameter is deprecated and generates warning into log file!

Related pages:

Implemented functions
Function arguments - types

Napíšte komentár