Converts a relative binary timestamp to a tm structure.

    Format

      #include <utc.h>

      int utc_reltime(*timetm, *tns, *inacctm, *ins, *utc)

         struct tm *timetm;
         long *tns;
         struct tm *inacctm;
         long *ins;
         const utc_t *utc;

1 - Parameters

    Input

 utc

    Relative binary timestamp.

    Output

 timetm

    Relative time component of the relative binary timestamp. The
    field tm_mday returns a value of -1 and the fields tm_year and
    tm_mon return values of zero. The field tm_yday contains the
    number of days of relative time.

 tns

    Nanoseconds since time component of the relative binary
    timestamp.

 inacctm

    Seconds of inaccuracy component of the relative binary timestamp.
    If the inaccuracy is finite, then tm_mday returns a value of -1
    and tm_mon and tm_year return values of zero. The field tm_yday
    contains the inaccuracy in days. If the inaccuracy is infinite,
    all tm structure fields return values of -1.

 ins

    Nanoseconds of inaccuracy component of the relative binary
    timestamp.

2 - Description

    The Relative Time routine converts a relative binary timestamp to
    a tm structure. Additional returns include nanoseconds since time
    and nanoseconds of inaccuracy.

3 - Returns

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

4 - Example

    See the sample program for the utc_mulftime routine.

5 - Related Functions

    utc_mkreltime