VMS Help DCE_DTS, Application Routines, utc_ascreltime  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME

   utc_ascreltime - Converts a relative binary timestamp to an ASCII
                    string that represents the time

 SYNOPSIS

   #include <dce/utc.h>

   int utc_ascreltime( char *cp,
                       const size_t stringlen,
                       utc_t *utc );

 PARAMETERS

   Input

   utc  Relative binary timestamp.

   stringlen
        Length of the cp buffer.

   Output

   cp   ASCII string that represents the time.

 DESCRIPTION

   The utc_ascreltime() routine converts a relative binary timestamp
   to an ASCII string that represents the time.

 RETURN VALUES

    0    Indicates that the routine executed successfully.

   -1    Indicates an invalid time parameter or invalid results.

 EXAMPLES

   See the sample program in the utc_abstime reference page.

 RELATED INFORMATION

   Functions: utc_mkascreltime