Lines Matching +full:at +full:- +full:the +full:- +full:time

20 .Nd convert date and time to ASCII
56 representing the time in seconds since
57 00:00:00 UTC, 1970-01-01,
59 string of the form
64 For years longer than four characters, the string is of the form
68 with five spaces before the year.
71 misleading values for out-of-range years.
75 function converts the calendar time pointed to by
77 to local time in exactly the same way as
79 and puts the string into the array pointed to by
81 (which contains at least 26 bytes) and returns
85 the thread-safe version
98 corrects for the time zone and any time zone adjustments
99 (such as Daylight Saving Time in the United States).
100 After filling in the
104 sets the
109 ASCII string that's the time zone abbreviation to be used with
114 converts to Coordinated Universal Time.
120 functions convert the calendar time pointed to by
122 into a broken-down time in exactly the same way as their non-reentrant
127 but instead store the result directly into the structure pointed to by
135 converts a time value contained in a
138 as shown in the above example,
139 and returns a pointer to the string.
141 uses the buffer pointed to by
143 (which should contain at least 26 bytes) and then
148 converts the broken-down time,
149 expressed as local time,
150 in the structure pointed to by
152 into a calendar time value with the same encoding as that of the values
153 returned by the
154 .Fn time
156 The original values of the
160 components of the structure are ignored,
161 and the original values of the other components are not restricted
167 to presume initially that summer time (for example, Daylight Saving Time
168 in the U.S.A.)\&
170 is or is not in effect for the specified time.
173 causes the
175 function to attempt to divine whether summer time is in effect
176 for the specified time; in this case it does not use a consistent
178 presented with the same argument.)
179 On successful completion, the values of the
183 components of the structure are set appropriately,
184 and the other components are set to represent the specified calendar time,
185 but with their values forced to their normal ranges; the final value of
193 returns the specified calendar time;
194 if the calendar time cannot be represented,
195 it returns \-1.
204 converts the broken-down time, as returned by
206 into a calendar time value with the same encoding as that of the values
207 returned by the
208 .Fn time
212 returns the difference between two calendar times,
213 .Pf ( Fa time1 No \- Fa time0 ) ,
216 Declarations of all the functions and externals, and the
218 structure, are in the
223 includes the following fields:
224 .Bd -literal -offset indent
225 	int tm_sec;	/* seconds (0 \- 60) */
226 	int tm_min;	/* minutes (0 \- 59) */
227 	int tm_hour;	/* hours (0 \- 23) */
228 	int tm_mday;	/* day of month (1 \- 31) */
229 	int tm_mon;	/* month of year (0 \- 11) */
230 	int tm_year;	/* year \- 1900 */
232 	int tm_yday;	/* day of year (0 \- 365) */
233 	int tm_isdst;	/* is summer time in effect? */
253 is non-zero if summer time is in effect.
256 is the offset (in seconds) of the time represented
258 of the Prime Meridian.
273 returns \-1 on error.
275 .Bl -tag -width "/usr/share/zoneinfo/posixrules" -compact
277 time zone information directory
279 local time zone file
281 used with POSIX-style TZ's
294 .Xr time 3 ,
308 .St -ansiC .
317 .St -p1003.1-2008 .
358 of the non re-entrant functions
366 will also be overwritten at the next call
374 The 1989 and 1999 editions of the C Standard say
375 that years from \-99 through 999 are converted without
379 restricted to years in the range 1900 through 2099.
384 The default system time zone may be set by running
385 .Dq Li zic -l timezone
386 as the superuser.
388 Avoid using out-of-range values with
391 .\" This file is in the public domain, so clarified as of
392 .\" 2009-05-17 by Arthur David Olson.