%DATETIME

Return the date and time

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)