NAME

   utc_mklocaltime - Converts a tm structure that expresses local time
                     to a binary timestamp

 SYNOPSIS

   #include <dce/utc.h>

   int utc_mklocaltime( utc_t *utc,
                        struct tm *timetm,
                        long tns,
                        struct tm *inacctm,
                        long ins );

 PARAMETERS

   Input

   timetm
          A tm structure that expresses the local time. On input,
          tm_wday and tm_yday are ignored; the value of tm_isdst
          should be -1.

   tns    Nanoseconds since the Time component.

   inacctm
          A tm structure that expresses days, hours, minutes, and seconds
          of inaccuracy.  If a null pointer is passed, or if tm_yday is
          negative, the inaccuracy is considered to be unspecified.  On
          input, tm_mday, tm_mon, tm_wday, and tm_isdst are ignored.

   ins    Nanoseconds of the inaccuracy component.

   Output

   utc    Resulting binary timestamp.

 DESCRIPTION

   The utc_mklocaltime() routine converts a tm structure that expresses
   local time to a binary timestamp.

   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.

   Additional inputs include nanoseconds since the last second of Time
   and nanoseconds of inaccuracy.

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Indicates an invalid time argument or invalid results.

 EXAMPLES

   See the sample program in the utc_cmpmidtime reference page.

 RELATED INFORMATION

   Functions: utc_localtime