3 datetime \- convert between TAI labels and seconds
5 .B #include <datetime.h>
7 void \fBdatetime_tai\fP(&\fIdt\fR,\fIt\fR);
9 datetime_sec \fBdatetime_untai\fP(&\fIdt\fR);
11 struct datetime \fIdt\fR;
15 International Atomic Time, TAI,
16 is the fundamental unit for time measurements.
17 TAI has one label for every second of real time,
18 without complications such as leap seconds.
27 is the year number minus 1900;
29 is the month number, from 0 (January) through 11 (December);
31 is the day of the month, from 1 through 31;
33 is the hour, from 0 through 23;
35 is the minute, from 0 through 59;
37 is the second, from 0 through 59;
39 is the day of the week, from 0 (Sunday) through 6 (Saturday);
41 is the day of the year, from 0 through 365.
45 library supports more convenient TAI manipulation with
46 the datetime_sec type.
47 A datetime_sec value, such as
49 is an integer referring to the
51 second after the beginning of 1970 TAI.
52 The first second of 1970 TAI was 0;
53 the next second was 1;
54 the last second of 1969 TAI was -1.
55 The difference between two datetime_sec values is a number
59 converts a datetime_sec to a TAI label.
71 and returns a datetime_sec.