Name

utc_mkgmtime -  Converts a tm structure that expresses GMT or UTC to a binary timestamp

Synopsis

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

Parameters

Input

timetmA tm structure that expresses GMT. On input, tm_wday and tm_yday are ignored; the value of tm_isdt should be -1. 

tnsNanoseconds since the time component. 

inacctmA 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. 

insNanoseconds of the inaccuracy component. 

Output

utcResulting binary timestamp. 

Description

The utc_mkgmtime() routine converts a tm structure that expresses GMT or UTC to a binary timestamp.  Additional inputs include nanoseconds since the last second of 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_cmpintervaltime(3dts) reference page. 

Related Information

Functions: utc_gmtime(3dts).