caltime(3)                                             caltime(3)



NAME
       caltime_tai - convert calendar dates and times

SYNTAX
       #include <caltime.h>
       #include <tai.h>

       void caltime_tai(&ct,&_t);
       void caltime_utc(&ct,&_t,&weekday,&yearday);

       struct caltime ct;
       struct tai _t;
       int *weekday;
       int *yearday;

DESCRIPTION
       caltime_tai  reads  a  date, time, and UTC offset from ct.
       It puts the corresponding TAI64 label into _t.

       caltime_utc reads a TAI64 label from _t.  It puts the  cor-
       responding date and time into ct, with UTC offset 0.

       caltime_utc  fills  in weekday and yearday the same way as
       caldate_frommjd.

LIMITATIONS
       The sequence of TAI64 labels has been determined  for  the
       next  few  hundred  billion  years.  The same is not true,
       however, for calendar dates and times.  New  leap  seconds
       are  added every year or two, as discussed in leapsecs(3);
       and the Gregorian calendar will change in a  few  thousand
       years,  as  discussed  in caldate_mjd(3).  This means that
       caltime_tai and caltime_utc are not useful for  dates  far
       in the future.

SEE ALSO
       caldate_mjd(3), caltime(3), tai(3), leapsecs(3)



                                                       caltime(3)
