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. Result is a value of Absolute time type.
Declaration
TIME %NextMonth(
INT in Offset,
UNIVAL in CalcTrigger,
TEXT in timeZone := %GetCurrentTimeZone()
)
Parameters
offset
Offset [s].
CalcTrigger
Object - 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!