Page tree
Skip to end of metadata
Go to start of metadata

%TimeFromItems function


Function
The function returns the absolute time from given time components.
Declaration
TIME %TimeFromItems(
   INT  in year,
   INT  in month,
   INT  in day,
   INT  in hour,
   INT  in min,
   INT  in sec,
   INT  in msec,
   TEXT in timeZone := %GetCurrentTimeZone()
 )
Parameters
yearYear
monthMonth
dayDay
hourHour
minMinute
secSecond
msecMillisecond
timeZoneName 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 number of hours, mi defines number of minutes, and ss defines number of seconds. Sign as well as 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). Empty text has the same meaning as function %GetCurrentTimeZone.
Note: For historical reasons, 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!
Example
%TimeFromItems(2002,9,12,10,15,0,0)   ; returns an abs. time corresponding to the value of 12-9-2002 10:15:00.000
Write a comment…