Get Current Local Time (CEELOCT) API


  Required Parameter Group:


  Omissible Parameter:


  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Get Current Local Time (CEELOCT) API returns the current local time in three formats: Lilian date (the number of days since 14 October 1582), Lilian timestamp (the number of seconds since 00:00:00 14 October 1582), and Gregorian character string (in the form YYYYMMDDHHMISS999'). These values are compatible with the other ILE date and time APIs and with existing language intrinsic functions. CEELOCT performs the same service, faster, than calling CEEUTC, CEEUTCO, and CEEDATM in succession.

Authorities and Locks

None.


Required Parameter Group

output_Lilian (output)
A 32-bit binary integer representing the current local date in the Lilian format. That is, day 1 is 15 October 1582, day 148 887 is 4 June 1990. If local time is not available, output_Lilian is set to 0 and CEELOCT ends with a nonzero feedback code.

output_seconds (output)
A 64-bit double floating point number representing the current local date and time 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 4 June 1990 is second number 12 863 905 201.078. If local time is not available, output_seconds is set to 0 and CEELOCT ends with a nonzero feedback code.

output_Gregorian (output)
A 23-byte character field, where the leading 17 bytes contain a string in the form YYYYMMDDHHMISS999 representing local year, month, day, hour, minute, second, and millisecond. The remaining 6 bytes are reserved and are currently set to the value 0.


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


Example

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.



API introduced: V2R3

[ Back to top | ILE CEE APIs | APIs by category ]