%NewTime function

Old name
%NewTimeT


Function
The function adds the relative time calculated from the defined parameters Year, Month, Day, Sec to the absolute time TimeA. The result is absolute time.
Declaration


TIME %NewTime(
   TIME in TimeA, 
   INT  in Year, 
   INT  in Month, 
   INT  in Day, 
   INT  in Sec,
   TEXT in timeZone := %GetCurrentTimeZone()
 )


Parameters


TimeAInput time.
YearNumber of years.
MonthNumber of months.
DayNumber of days.
SecNumber of seconds.
timeZone


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


Implemented functions
Function arguments - types