Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
caltime(3)		    Library Functions Manual		      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 corre-
     sponding 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)

								      caltime(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=caltime_tai&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help