Guardian Procedure Calls Reference Manual

CONVERTTIMESTAMP Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Related Programming Manual
Summary
The CONVERTTIMESTAMP procedure converts a Greenwich mean time (GMT) timestamp to or
from a local-time-based timestamp within any accessible node in the network.
A local timestamp can be in local standard time (LST), which does not include daylight saving time
(DST), or in local civil time (LCT), which does include DST.
DST is a system to extend the amount of daylight hours available in summer by putting the clock
forward by an hour. Before 2007, DST in the United States, begins at 2:00 a.m. on the first Sunday
of April and ends at 2:00 a.m. DST (1:00 a.m. LST) on the last Sunday of October. From 2007
onwards, DST will begin at 2:00 a.m. on the second Sunday of March and end at 2:00 a.m. DST
(1:00 a.m. LST) on the first Sunday of November.
Syntax for C Programmers
#include <cextdecs(CONVERTTIMESTAMP)>
long long CONVERTTIMESTAMP ( long long julian-timestamp
,[ short direction ]
,[ short node ]
,[ short _near *error ] );
Syntax for TAL Programmers
ret-time := CONVERTTIMESTAMP ( julian-timestamp ! i
,[ direction ] ! i
,[ node ] ! i
,[ error ] ); ! o
Parameters
julian-timestamp
input
FIXED:value
is a four-word Julian timestamp to be converted.
CONVERTTIMESTAMP Procedure 221