The Convert Seconds to Integers (CEESECI) API converts a number representing
the number of seconds since 00:00:00 14 October 1582 to seven separate binary
integers representing year, month, day, hour, minute, second, and millisecond.
Use CEESECI instead of CEEDATM when the output is needed in numeric format
rather than in character format.
Authorities and Locks
None.
Required Parameter Group
input_seconds (input)
A 64-bit double floating-point number representing 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). The valid range is 86 400 to
265 621 679 999.999 (23:59:59.999 31 December 9999).
If input_seconds is not valid, all output parameters are set to
zero.
output_year (output)
A 32-bit binary integer representing year. The range is 1582 through
9999.
output_month (output)
A 32-bit binary integer representing month. The range is 1 through 12.
output_day (output)
A 32-bit binary integer representing day. The range is 1 through 31.
output_hours (output)
A 32-bit binary integer representing hours. The range is 0 through 23.
output_minutes (output)
A 32-bit binary integer representing minutes. The range is 0 through
59.
output_seconds (output)
A 32-bit binary integer representing seconds. The range is 0 through
59.
output_milliseconds (output)
A 32-bit binary integer representing milliseconds. The range is 0 through
999.
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
CEE0000
The API completed successfully
Severity: 00
CEE2505
The value for seconds is out of range
Severity: 30
CEE9902
Unexpected user error occurred in &1
Severity: 30
Usage Notes
The inverse of CEESECI is CEEISEC. The CEEISEC API converts integer year,
month, day, hour, minute, second, and millisecond to number of seconds.
If the input value is a Lilian date instead of seconds, multiply the Lilian
date by 86 400 (number of seconds in a day), and pass the new value to
CEESECI.
CEESECI can be used to do date arithmetic that cannot otherwise be done with
Lilian dates or number of seconds.