Name

utc_reltime - Converts a relative binary timestamp to a tm structure

Synopsis

#include <dce/utc.h> int utc_reltime(
struct tm ∗timetm,
long ∗tns,
struct tm ∗inacctm,
long ∗ins,
utc_t ∗utc);

Parameters

Input

utcRelative binary timestamp. 

Output

timetmRelative 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 0 (zero).  The field tm_yday contains the number of days of relative time. 

tnsNanoseconds since the time component of the relative binary timestamp. 

inacctmSeconds of the 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 0 (zero).  The field tm_yday contains the inaccuracy in days.  If the inaccuracy is unspecified, all tm structure fields return values of −1. 

insNanoseconds of the inaccuracy component of the relative binary timestamp. 

Description

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

Return Values

 0Indicates that the routine executed successfully. 

-1Indicates an invalid time argument or invalid results. 

Examples

See the sample program in the utc_mulftime(3dts) reference page. 

Related Information

Functions: utc_mkreltime(3dts).