caltime(3) caltime(3) NNAAMMEE caltime_tai - convert calendar dates and times SSYYNNTTAAXX ##iinncclluuddee <> ##iinncclluuddee <> void ccaallttiimmee__ttaaii(&_c_t,&_t); void ccaallttiimmee__uuttcc(&_c_t,&_t,&_w_e_e_k_d_a_y,&_y_e_a_r_d_a_y); struct caltime _c_t; struct tai _t; int *_w_e_e_k_d_a_y; int *_y_e_a_r_d_a_y; DDEESSCCRRIIPPTTIIOONN ccaallttiimmee__ttaaii reads a date, time, and UTC offset from _c_t. It puts the corresponding TAI64 label into _t. ccaallttiimmee__uuttcc reads a TAI64 label from _t. It puts the corresponding date and time into _c_t, with UTC offset 0. ccaallttiimmee__uuttcc fills in _w_e_e_k_d_a_y and _y_e_a_r_d_a_y the same way as ccaallddaattee__ffrroomm-- mmjjdd. LLIIMMIITTAATTIIOONNSS 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 lleeaappsseeccss(3); and the Gregorian calendar will change in a few thou- sand years, as discussed in ccaallddaattee__mmjjdd(3). This means that ccaall-- ttiimmee__ttaaii and ccaallttiimmee__uuttcc are not useful for dates far in the future. SSEEEE AALLSSOO caldate_mjd(3), caltime(3), tai(3), leapsecs(3) caltime(3)