<< Back to man.ChinaUnix.net


     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)









Man(1) output converted with man2html