Guardian Procedure Calls Reference Manual

INTERPRETINTERVAL Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Example
Related Programming Manual
Summary
The INTERPRETINTERVAL procedure takes a fixed variable (quad) containing a value representing
a number of microseconds and converts it into a combination of days, hours, minutes, seconds,
milliseconds, and microseconds. All output parameters are optional.
This procedure is similar to CONVERTPROCESSTIME except that INTERPRETINTERVAL places no
limit on the timestamp value.
Syntax for C Programmers
#include <cextdecs(INTERPRETINTERVAL)>
__int32_t INTERPRETINTERVAL ( long long time
,[ short _near *hours ]
,[ short _near *minutes ]
,[ short _near *seconds ]
,[ short _near *milsecs ]
,[ short _near *microsecs ] );
• 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
days := INTERPRETINTERVAL ( time ! i
,[ hours ] ! o
,[ minutes ] ! o
,[ seconds ] ! o
,[ milsecs ] ! o
,[ microsecs ] ); ! o
Parameters
time
input
FIXED:value
specifies the four-word fixed time interval.
hours
output
INT:ref:1
returns the number of hours in the interval of time (0 or greater).
730 Guardian Procedure Calls (H-K)