TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-79

#CONVERTTIMESTAMP Built-In Function

Use #CONVERTTIMESTAMP to convert a Greenwich mean time (GMT) timestamp to

or from a local time-based timestamp on any accessible node in a network. The

resulting timestamp is still in four-word format (as returned by #JULIANTIMESTAMP),

but its value is adjusted for the time differential between local time and GMT. Local

time can be either standard time or civil time (standard time adjusted for daylight

saving).

gmt-timestamp

is the timestamp to be converted.

direction

is a number that represents the direction of conversion:

\node-name

is the name of the system where conversion is to be done.

Result

#CONVERTTIMESTAMP returns a numeric error code. If the conversion is successful,

the error code (zero) is followed by a space and the converted timestamp.

The codes are:

#CONVERTTIMESTAMP gmt-timestamp direction [ \node-name ]

Number Conversion

0 GMT to local civil time (LCT)

1 GMT to local standard time (LST)

2 LCT to GMT

3 LST to GMT

Code Condition

-2 Impossible LCT

-1 Ambiguous LCT

0 No errors; successful conversion

1 Daylight-saving time (DST) range error

2 DST table not loaded

>2 File-system error (attempting to reach \ node-name)