Name

caltime_tai — convert calendar dates and times

Synopsis

#include <caltime.h>

#include <tai.h>

void \fBcaltime_tai\fP(&\fIct\fR,&\fIt\fR);

void \fBcaltime_utc\fP(&\fIct\fR,&\fIt\fR,&\fIweekday\fR,&\fIyearday\fR);

struct caltime \fIct\fR;

struct tai \fIt\fR;

int *\fIweekday\fR;

int *\fIyearday\fR;

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 corresponding 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)

Author

Original code and documentation by Daniel J. Bernstein. Converted to DocBook XML by Jonathan de Boyne Pollard.