Fri May 10 18:36:14 1996 Roland McGrath <roland@delasyd.gnu.ai.mit.edu>
[kopensolaris-gnu/glibc.git] / time / time.h
1 /* Copyright (C) 1991, 92, 93, 94, 95, 96 Free Software Foundation, Inc.
2 This file is part of the GNU C Library.
3
4 The GNU C Library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 License, or (at your option) any later version.
8
9 The GNU C Library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB.  If
16 not, write to the Free Software Foundation, Inc., 675 Mass Ave,
17 Cambridge, MA 02139, USA.  */
18
19 /*
20  *      ANSI Standard: 4.12 DATE and TIME       <time.h>
21  */
22
23 #ifndef _TIME_H
24
25 #if     !defined(__need_time_t) && !defined(__need_clock_t)
26 #define _TIME_H         1
27 #include <features.h>
28
29 __BEGIN_DECLS
30
31 #endif
32
33 #ifdef  _TIME_H
34 /* Get size_t and NULL from <stddef.h>.  */
35 #define __need_size_t
36 #define __need_NULL
37 #include <stddef.h>
38 #endif /* <time.h> included.  */
39
40
41
42 #ifdef  _TIME_H
43
44 /* This defines CLOCKS_PER_SEC, which is the number of processor clock
45    ticks per second.  */
46 #include <timebits.h>
47
48 /* This is the obsolete POSIX.1-1988 name for the same constant.  */
49 #ifdef  __USE_POSIX
50 #define CLK_TCK         CLOCKS_PER_SEC
51 #endif
52
53 #endif /* <time.h> included.  */
54
55
56 #if     !defined(__clock_t_defined) &&                  \
57         (defined(_TIME_H) || defined(__need_clock_t))
58 #define __clock_t_defined       1
59
60 /* Returned by `clock'.  */
61 typedef long int clock_t;
62
63 #endif /* clock_t not defined and <time.h> or need clock_t.  */
64 #undef  __need_clock_t
65
66 #if     !defined(__time_t_defined) &&                   \
67         (defined(_TIME_H) || defined(__need_time_t))
68 #define __time_t_defined        1
69
70 #include <gnu/types.h>
71
72 /* Returned by `time'.  */
73 typedef __time_t time_t;
74
75 #endif /* time_t not defined and <time.h> or need time_t.  */
76 #undef  __need_time_t
77
78
79 #ifdef  _TIME_H
80 /* Used by other time functions.  */
81 struct tm
82 {
83   int tm_sec;                   /* Seconds.     [0-61] (2 leap seconds) */
84   int tm_min;                   /* Minutes.     [0-59] */
85   int tm_hour;                  /* Hours.       [0-23] */
86   int tm_mday;                  /* Day.         [1-31] */
87   int tm_mon;                   /* Month.       [0-11] */
88   int tm_year;                  /* Year - 1900.  */
89   int tm_wday;                  /* Day of week. [0-6] */
90   int tm_yday;                  /* Days in year.[0-365] */
91   int tm_isdst;                 /* DST.         [-1/0/1]*/
92   long int tm_gmtoff;           /* Seconds west of UTC.  */
93   __const char *tm_zone;        /* Timezone abbreviation.  */
94 };
95
96 #endif /* <time.h> included.  */
97
98
99 #ifdef  _TIME_H
100 /* Time used by the program so far (user time + system time).
101    The result / CLOCKS_PER_SECOND is program time in seconds.  */
102 extern clock_t clock __P ((void));
103
104 /* Return the current time and put it in *TIMER if TIMER is not NULL.  */
105 extern time_t time __P ((time_t *__timer));
106
107 /* Return the difference between TIME1 and TIME0.  */
108 extern double difftime __P ((time_t __time1, time_t __time0))
109      __attribute__ ((__const__));
110
111 /* Return the `time_t' representation of TP and normalize TP.  */
112 extern time_t mktime __P ((struct tm *__tp));
113
114 /* Subroutine of `mktime'.  Return the `time_t' representation of TP and
115    normalize TP, given that a `struct tm *' maps to a `time_t' as performed
116    by FUNC.  Keep track of next guess for time_t offset in *OFFSET.  */
117 extern time_t __mktime_internal __P ((struct tm *__tp,
118                                       struct tm *(*__func) (const time_t *,
119                                                             struct tm *),
120                                       time_t *__offset));
121
122
123 /* Format TP into S according to FORMAT.
124    Write no more than MAXSIZE characters and return the number
125    of characters written, or 0 if it would exceed MAXSIZE.  */
126 extern size_t strftime __P ((char *__s, size_t __maxsize,
127                          __const char *__format, __const struct tm *__tp));
128
129
130 /* Return the `struct tm' representation of *TIMER
131    in Universal Coordinated Time (aka Greenwich Mean Time).  */
132 extern struct tm *gmtime __P ((__const time_t *__timer));
133
134 /* Return the `struct tm' representation
135    of *TIMER in the local timezone.  */
136 extern struct tm *localtime __P ((__const time_t *__timer));
137
138 #ifdef  __USE_REENTRANT
139 /* Return the `struct tm' representation of *TIMER in UTC,
140    using *TP to store the result.  */
141 extern struct tm *__gmtime_r __P ((__const time_t *__timer,
142                                    struct tm *__tp));
143 extern struct tm *gmtime_r __P ((__const time_t *__timer,
144                                  struct tm *__tp));
145
146 /* Return the `struct tm' representation of *TIMER in local time,
147    using *TP to store the result.  */
148 extern struct tm *__localtime_r __P ((__const time_t *__timer,
149                                       struct tm *__tp));
150 extern struct tm *localtime_r __P ((__const time_t *__timer,
151                                     struct tm *__tp));
152 #endif
153
154 /* Compute the `struct tm' representation of *T,
155    offset OFFSET seconds east of UTC,
156    and store year, yday, mon, mday, wday, hour, min, sec into *TP.  */
157 extern void __offtime __P ((__const time_t *__timer,
158                             long int __offset,
159                             struct tm *__TP));
160
161 /* Return a string of the form "Day Mon dd hh:mm:ss yyyy\n"
162    that is the representation of TP in this format.  */
163 extern char *asctime __P ((__const struct tm *__tp));
164
165 /* Equivalent to `asctime(localtime(timer))'.  */
166 extern char *ctime __P ((__const time_t *__timer));
167
168
169 /* Defined in localtime.c.  */
170 extern char *__tzname[2];       /* Current timezone names.  */
171 extern int __daylight;          /* If it is daylight savings time.  */
172 extern long int __timezone;     /* Seconds west of UTC.  */
173
174 /* Set time conversion information from the TZ environment variable.
175    If TZ is not defined, a locale-dependent default is used.  */
176 extern void __tzset __P ((void));
177
178 #ifdef  __USE_POSIX
179 /* Same as above.  */
180 extern char *tzname[2];
181
182 /* Return the maximum length of a timezone name.
183    This is what `sysconf (_SC_TZNAME_MAX)' does.  */
184 extern long int __tzname_max __P ((void));
185
186 extern void tzset __P ((void));
187 #ifdef  __OPTIMIZE__
188 #define tzset() __tzset()
189 #endif /* Optimizing.  */
190 #endif
191
192 #ifdef  __USE_SVID
193 extern int daylight;
194 extern long int timezone;
195
196 /* Set the system time to *WHEN.
197    This call is restricted to the superuser.  */
198 extern int stime __P ((__const time_t *__when));
199 #endif
200
201
202 /* Nonzero if YEAR is a leap year (every 4 years,
203    except every 100th isn't, and every 400th is).  */
204 #define __isleap(year)  \
205   ((year) % 4 == 0 && ((year) % 100 != 0 || (year) % 400 == 0))
206
207
208 #ifdef __USE_MISC
209 /* Miscellaneous functions many Unices inherited from the public domain
210    localtime package.  These are included only for compatibility.  */
211
212 /* Like `mktime', but for TP represents Universal Time, not local time.  */
213 extern time_t timegm __P ((struct tm *__tp));
214
215 /* Another name for `mktime'.  */
216 extern time_t timelocal __P ((struct tm *__tp));
217
218 /* Return the number of days in YEAR.  */
219 extern int dysize __P ((int __year));
220 #endif
221
222
223 /* POSIX.4 structure for a time value.  This is like a `struct timeval' but
224    has nanoseconds instead of microseconds.  */
225 struct timespec
226   {
227     long int ts_sec;            /* Seconds.  */
228     long int ts_nsec;           /* Nanoseconds.  */
229   };
230
231 #ifdef __USE_POSIX
232 /* Pause execution for a number of nanoseconds.  */
233 extern int nanosleep __P ((__const struct timespec *__requested_time,
234                            struct timespec *__remaining));
235 #endif
236
237
238 __END_DECLS
239
240 #endif /* <time.h> included.  */
241
242 #endif /* <time.h> not already included.  */