Convert Seconds to Integers (CEESECI) API

Required Parameter Group:

1	input_seconds	Input	FLOAT8
2	output_year	Output	INT4
3	output_month	Output	INT4
4	output_day	Output	INT4
5	output_hours	Output	INT4
6	output_minutes	Output	INT4
7	output_seconds	Output	INT4
8	output_milliseconds	Output	INT4

Omissible Parameter:

Output

FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

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.