Convert Integers to Seconds (CEEISEC) API

Required Parameter Group:

1	input_year	Input	INT4
2	input_month	Input	INT4
3	input_day	Input	INT4
4	input_hours	Input	INT4
5	input_minutes	Input	INT4
6	input_seconds	Input	INT4
7	input_milliseconds	Input	INT4
8	output_seconds	Output	FLOAT8

Omissible Parameter:

Output

FEEDBACK

  Service Program Name: QLEAWI

  Default Public Authority: *USE

  Threadsafe: Yes

The Convert Integers to Seconds (CEEISEC) API converts separate binary integers representing year, month, day, hour, minute, second, and millisecond to a number representing the number of seconds since 00:00:00 14 October 1582. Use CEEISEC instead of CEESECS when the input is in numeric format rather than character format.

Authorities and Locks

None.

Required Parameter Group

input_year (input)

A 32-bit binary integer representing year. The range is 1582 through 9999.

input_month (input)

A 32-bit binary integer representing month. The range is 1 through 12.

input_day (input)

A 32-bit binary integer representing day. The range is 1 through 31.

input_hours (input)

A 32-bit binary integer representing hours. The range is 0 through 23.

input_minutes (input)

A 32-bit binary integer representing minutes. The range is 0 through 59.

input_seconds (input)

A 32-bit binary integer representing seconds. The range is 0 through 59.

input_milliseconds (input)

A 32-bit binary integer representing milliseconds. The range is 0 through 999.

output_seconds (output)

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 range is 86,400 to 265 621 679 999.999 (23:59:59.999 31 December 9999).

If any input values are not valid, output_seconds is set to zero.

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

CEE2510

The value for hour is not valid

Severity: 30

CEE2511

The value for day is not valid

Severity: 30

CEE2513

The value for Lilian date is not valid

Severity: 30

CEE2514

The value for Lilian year is not valid

Severity: 30

CEE2515

The value for millisecond is not valid

Severity: 30

CEE2516

The minute value is not valid

Severity: 30

CEE2517

The value for month is not valid

Severity: 30

CEE2519

The value for second is not valid

Severity: 30

CEE9902

Unexpected user error occurred in &1

Severity: 30

Usage Notes

The inverse of CEEISEC is CEESECI. The CEESECI API converts number of seconds to integer year, month, day, and so forth.

To convert output_seconds to a Lilian day number, divide output_seconds by 86 400 (number of seconds in a day).

CEEISEC can be used to do date arithmetic that cannot otherwise be done with Lilian dates or number of seconds. For example, to add exactly 6 months to a date rather than add 180 days, use CEEISEC.