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:
9 | fc | 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.
API introduced: V2R3
[ Back to top | ILE CEE APIs | APIs by category ]