NAME

   utc_localzone - Gets the local time zone label and offset from GMT,
                   given utc

 SYNOPSIS

   #include <dce/utc.h>

   int utc_localzone( char *tzname,
                      size_t tzlen,
                      long *tdf,
                      int *isdst,
                      utc_t *utc );

 PARAMETERS

   Input

   tzlen
       Length of the tzname buffer.

   utc
       Binary timestamp. Use NULL if you want this routine to use the
       current time for this parameter.

   Output

   tzname
       Character string long enough to hold the time zone label.

   tdf Longword with differential in seconds east of GMT.

   isdst
       Integer with a value of 0 (zero) if standard time is in effect
       or a value of 1 if daylight saving time is in effect.

 DESCRIPTION

   The utc_localzone() routine gets the local time zone label and offset
   from GMT, given utc.

   The user's environment determines the time zone rule (details are
   system dependent).

   If the user's environment does not specify a time zone rule, the
   system's rule is used (details of the rule are system dependent).
   For example, on OpenVMS systems, the rule pointed to by the filename
   in SYS$SYSTEM:SYS$TIMEZONE_SRC.DAT applies.

 NOTES

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

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Indicates an invalid time argument or an insufficient buffer.

 EXAMPLES

   See the sample program in the utc_gmtzone reference page.

 RELATED INFORMATION

   Functions: utc_anyzone
              utc_gmtzone
              utc_localtime