Get Universal Time Coordinated (CEEUTC) API

The Get Universal Time Coordinated (CEEUTC) API returns the current Universal Time Coordinated as both a Lilian date and as the number of seconds since 00:00:00 14 October 1582. These values are compatible with the other ILE date and time APIs.

Authorities and Locks

None.

Required Parameter Group

output_UTC_Lilian (output)

A 32-bit binary integer representing the current date in Greenwich, England, in the Lilian format. That is, the number of days since 14 October 1582, also known as Universal Time Coordinated (UTC). For example, 16 May 1988 is day number 148 138. If UTC is not available from the system, output_UTC_Lilian is set to 0 and CEEUTC ends with a nonzero feedback code.

output_UTC_seconds (output)

A 64-bit double floating-point number representing the current date and time in Greenwich, England as the number of seconds since 00:00:00 on 14 October 1582. For example, 00:00:01 on 15 October 1582 is second number 86 401 (24*60*60 + 01). 19:00:01.078 on 16 May 1988 is second number 12 799 191 601.078. If UTC is not available from the system, output_UTC_seconds is set to 0 and CEEUTC ends with a nonzero feedback code.

Omissible Parameter

fc (output)

A 12-byte feedback code passed by reference. If specified as an argument, feedback information (a condition token) is returned to the calling procedure. If not specified and the requested operation was not successfully completed, the condition is signaled to the condition manager.

Feedback Codes and Conditions

Usage Notes

• Use CEELOCT to obtain local time.

• Use CEEUTCO to obtain the offset from UTC to local time.

• The values returned by CEEUTC are handy for wall-clock calculations.

• CEEDATE will convert output_UTC_Lilian to character date, and CEEDATM will convert output_UTC_seconds to character timestamp.

Example

See Code disclaimer information for information pertaining to code examples.

• Extract current UTC and convert to local date and time in YYMMDDHHMMSS format:

  CALL CEEUTC (days, secs, fc);
  CALL CEEUTCO (hrs, mins, secoffset, fc);
  secs = secs + secoffset;
  CALL CEEDATM (secs, 'YYMMDDHHMISS', localdatetime,
                fc);