caltime(3)caltime(3)NAMEcaltime_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;
DESCRIPTIONcaltime_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 corresponding date
and time into ct, with UTC offset 0.
caltime_utc fills in weekday and yearday the same way as caldate_from‐
mjd.
LIMITATIONS
The sequence of TAI64 labels has been determined for the next few hun‐
dred 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 thou‐
sand years, as discussed in caldate_mjd(3). This means that cal‐
time_tai and caltime_utc are not useful for dates far in the future.
SEE ALSOcaldate_mjd(3), caltime(3), tai(3), leapsecs(3)caltime(3)
