utc_mkgmtime(3dts)

Synopsis

#include <dce/utc.h>

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

Parameters

Input

timetm
A tm structure that expresses GMT. On input, tm_wday and tm_yday are ignored; the value of tm_isdt 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_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
~0 Indicates that the routine executed successfully.

1 Indicates an invalid time argument or invalid results.

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

Related Information
Function: utc_gmtime(3dts)