Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (H-K)

Guardian Procedure Calls Reference Manual—522629-013

7-49

INTERPRETTIMESTAMP Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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

•

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

Parameters

ret-date-time returned value

INT(32)

returns the 32-bit Julian day number. A value of -1D is returned if the supplied

Julian timestamp is out of range (see “Considerations”).

julian-timestamp input

FIXED:value

is a 64-bit Julian timestamp to be converted.

#include <cextdecs(INTERPRETTIMESTAMP)>

__int32_t INTERPRETTIMESTAMP ( long long julian-timestamp

,short _near *date-and-time );

ret-date-time := INTERPRETTIMESTAMP ( julian-timestamp ! i

,date-and-time ); ! o