Name

utc_pointtime - Converts a binary timestamp to three binary timestamps that represent the earliest, most likely, and latest time

Synopsis

#include <dce/utc.h> int utc_pointtime(
utc_t ∗utclp,
utc_t ∗utcmp,
utc_t ∗utchp,
utc_t ∗utc);

Parameters

Input

utcBinary timestamp or relative binary timestamp.  Use NULL if you want this routine to use the current time for this parameter. 

Output

utclpLowest (earliest) possible absolute time or shortest possible relative time that the input timestamp can represent. 

utcmpMidpoint of the input timestamp. 

utchpHighest (latest) possible absolute time or longest possible relative time that the input timestamp can represent. 

Description

The utc_pointtime() routine converts a binary timestamp to three binary timestamps that represent the earliest, latest, and most likely (midpoint) times.  If the input is a relative binary time, the outputs represent relative binary times. 

Notes

All outputs have zero inaccuracy.  An error is returned if the input binary timestamp has an unspecified inaccuracy. 

Return Values

 0Indicates that the routine executed successfully. 

-1Indicates an invalid time argument. 

Examples

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

Related Information

Functions: utc_boundtime(3dts), utc_spantime(3dts).