%DATETIME
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
date = %DATETIME[(utc_offset)]
Return value
date
The current date and time. (a20)
Arguments
utc_offset
(optional) The optional offset in minutes east of the Greenwich Meridian. (n)
Discussion
The date and time are returned in the format YYYYMMDDhhmmssuuuuuu:
YYYY |
The four-digit year (for example, 2016) |
MM |
The month (01 through 12) |
DD |
The day of the month (01 through 31) |
hh |
The hour (00 through 23) |
mm |
The minute of the hour (00 through 59) |
ss |
The second of the minute (00 through 59) |
uuuuuu |
The microseconds (000000 through 999999) |
If your operating system doesn’t provide all six microsecond digits, any unknown digits are returned as zeros.
If utc_offset is specified, %DATETIME returns the Coordinated Universal Time (UTC) date and time. If utc_offset is 0 or not specified, the date and time are the local date and time.
See also
%TIMEZONE routine
Examples
subroutine sh_date_time record group datetime ,a20 group date ,a8 year ,a4 month ,a2 day ,a2 endgroup group time ,a12 hour ,a2 minute ,a2 second ,a2 msecond ,a6 endgroup endgroup string ,a60 slen ,d3 proc datetime = %datetime xcall s_bld(string, slen, & "Date and Time: %A = %A/%A/%A %A:%A:%A", datetime, day, month, & year, hour, minute, second) writes(TTCHN, string) return endsubroutine
In the example below, passing %TIMEZONE as the optional argument to %DATETIME causes %DATETIME to return the UTC date and time string.
utc_date = %datetime(%timezone)