taia_now(3) [debian man page]

taia_now(3)						     Library Functions Manual						       taia_now(3)

NAME

       taia_now - get current time

SYNTAX

       #include <taia.h>

       extern int taia_now(struct taia* t);

DESCRIPTION

       taia_now  puts  the  current  time  into t. More precisely: tai_now puts into t its best guess as to the TAI64NA label for the 1-attosecond
       interval that contains the current time.

       This implementation of taia_now assumes that the time_t returned from the  time	function  represents  the  number  of  TAI  seconds  since
       1970-01-01 00:00:10 TAI. This matches the convention used by the Olson tz library in ``right'' mode.

       Beware  that  many  clocks  are not set accurately, and even the best scientific clocks are nowhere near 1-attosecond accuracy; however, an
       inaccurate clock may still produce reasonably accurate time differences.

SEE ALSO

       tai_now(3)

																       taia_now(3)

datetime(3)						     Library Functions Manual						       datetime(3)

NAME

       datetime - convert between TAI labels and seconds

SYNTAX

       #include <datetime.h>

       void datetime_tai(&dt,t);

       datetime_sec datetime_untai(&dt);

       struct datetime dt;
       datetime_sec t;

DESCRIPTION

       International  Atomic  Time,  TAI, is the fundamental unit for time measurements.  TAI has one label for every second of real time, without
       complications such as leap seconds.

       A struct datetime variable, such as dt, stores a TAI label.  dt.year is the year number minus 1900; dt.mon is  the  month  number,  from  0
       (January)  through 11 (December); dt.mday is the day of the month, from 1 through 31; dt.hour is the hour, from 0 through 23; dt.min is the
       minute, from 0 through 59; dt.sec is the second, from 0 through 59; dt.wday is the day of the week, from 0 (Sunday) through  6  (Saturday);
       dt.yday is the day of the year, from 0 through 365.

       The  datetime library supports more convenient TAI manipulation with the datetime_sec type.  A datetime_sec value, such as t, is an integer
       referring to the tth second after the beginning of 1970 TAI.  The first second of 1970 TAI was 0; the next second was 1; the last second of
       1969 TAI was -1.  The difference between two datetime_sec values is a number of real-time seconds.

       datetime_tai converts a datetime_sec to a TAI label.

       datetime_untai reads a TAI label (specifically dt.year, dt.mon, dt.mday, dt.hour, dt.min, and dt.sec) and returns a datetime_sec.

SEE ALSO

       now(3)

																       datetime(3)