The function adds the relative time calculated from the defined parameters Year, Month, Day,
Sec to the absolute time TimeA. Result is an absolute time.
Declaration
TIME %NewTime(
TIME in TimeA,
INT in Year,
INT in Month,
INT in Day,
INT in Sec,
INT in timeZone := %GetTimeZone()
)
Parameters
TimeA
Input time.
Year
Number of years.
Month
Number of months.
Day
Number of days.
Sec
Number of seconds.
timeZone
Forced time zone to convert to a local time. It is
set as a time zone offset from UTC during winter in seconds.
Note
If the target date does not exist, the function returns the date value of the last existing day in the particular target month,
e.g.:
_Date := %StrToTime("10:00:00 31-01-2007")
_Date := %NewTime(_Date,0,1,0,0) ;increases the month value by one -> 28.2.2007 10:00:00.000