Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (C)

Guardian Procedure Calls Reference Manual—522629-013

3-147

CONVERTTIMESTAMP Procedure

Summary

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

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 available during summer months by

advancing the clock one hour. In most states in the United States, DST begins at 2:00

a.m. on the first Sunday in April and ends at 2:00 a.m. DST (1:00 a.m. LST) on the last

Sunday in October.

Syntax for C Programmers

Syntax for TAL Programmers

Parameters

ret-time returned value

FIXED

returns the converted Julian timestamp.

#include <cextdecs(CONVERTTIMESTAMP)>

long long CONVERTTIMESTAMP( long long julian-timestamp

,[ short direction ]

,[ short node ]

,[ short _near *error ] );

ret-time := CONVERTTIMESTAMP ( julian-timestamp ! i

,[ direction ] ! i

,[ node ] ! i

,[ error ] ); ! o