HELPLIB.HLB  —  DECdts  utc_anyzone
    Gets the time zone label and offset from GMT, using the TDF
    contained in the input utc.

    Format

      #include <utc.h>

      int utc_anyzone(tzname, tzlen, *tdf, isdst, *utc)

         char tzname;
         size_t tzlen;
         long *tdf;
         int *isdst;
         const utc_t *utc;

1  –  Parameters

    Input

 tzlen

    Length of the tzname buffer.

 utc

    Binary time.

    Output

 tzname

    Character string that is long enough to hold the time zone label.

 tdf

    Longword with differential in seconds east or west of GMT.

 isdst

    Integer with a value of -1, indicating that no information is
    supplied as to whether it is standard time or daylight saving
    time. A value of -1 is always returned.

2  –  Description

    The Any Zone routine gets the time zone label and offset from
    GMT, using the TDF contained in the input utc. The label returned
    is always of the form GMT + n or GMT - n, where n is the TDF
    expressed in hours:minutes. (The label associated with an
    arbitrary time zone is not known; only the offset is known.)

3  –  Notes

    All of the output parameters are optional. No value is returned
    and no error occurs if the pointer is null.

4  –  Returns

     0   Indicates that the routine executed successfully.
    -1   Indicates an invalid time argument or an insufficient buffer.

5  –  Example

    See the sample program for the utc_anytime routine.

6  –  Related Functions

    utc_anytime, utc_gmtzone, utc_localzone
Close Help