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
       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 ALSO
       caldate_mjd(3), caltime(3), tai(3), leapsecs(3)

								    caltime(3)

NAME | SYNTAX | DESCRIPTION | LIMITATIONS | SEE ALSO

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

home | help