Guardian Procedure Calls Reference Manual

INTERPRETTIMESTAMP Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The INTERPRETTIMESTAMP procedure converts a 64-bit Julian timestamp into a Gregorian (the
common civil calendar) date and time of day.
Syntax for C Programmers
#include <cextdecs(INTERPRETTIMESTAMP)>
__int32_t INTERPRETTIMESTAMP ( long long julian-timestamp
,short _near *date-and-time );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
ret-date-time := INTERPRETTIMESTAMP ( julian-timestamp ! i
,date-and-time ); ! o
Parameters
julian-timestamp
input
FIXED:value
is a 64-bit Julian timestamp to be converted.
date-and-time
output
INT:ref:8
returns an array containing the date and time of day. A value of -1 is returned in word [0] if
the supplied Julian timestamp is out of range (see Considerations). The array has this form:
(1984, 1985, ...)The Gregorian year[0]
(1-12)The Gregorian month[1]
(1-31)The Gregorian day of month[2]
(0-23)The hour of the day[3]
(0-59)The minute of the hour[4]
(0-59)The second of the minute[5]
734 Guardian Procedure Calls (H-K)