master
1/*
2 * Copyright (c) 2023 Apple Computer, Inc. All rights reserved.
3 *
4 * @APPLE_LICENSE_HEADER_START@
5 *
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
11 * file.
12 *
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
20 *
21 * @APPLE_LICENSE_HEADER_END@
22 */
23/*
24 * Copyright (c) 1989, 1993
25 * The Regents of the University of California. All rights reserved.
26 * (c) UNIX System Laboratories, Inc.
27 * All or some portions of this file are derived from material licensed
28 * to the University of California by American Telephone and Telegraph
29 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
30 * the permission of UNIX System Laboratories, Inc.
31 *
32 * Redistribution and use in source and binary forms, with or without
33 * modification, are permitted provided that the following conditions
34 * are met:
35 * 1. Redistributions of source code must retain the above copyright
36 * notice, this list of conditions and the following disclaimer.
37 * 2. Redistributions in binary form must reproduce the above copyright
38 * notice, this list of conditions and the following disclaimer in the
39 * documentation and/or other materials provided with the distribution.
40 * 3. All advertising materials mentioning features or use of this software
41 * must display the following acknowledgement:
42 * This product includes software developed by the University of
43 * California, Berkeley and its contributors.
44 * 4. Neither the name of the University nor the names of its contributors
45 * may be used to endorse or promote products derived from this software
46 * without specific prior written permission.
47 *
48 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
49 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
50 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
51 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
52 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
53 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
54 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
55 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
56 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
57 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
58 * SUCH DAMAGE.
59 *
60 * @(#)time.h 8.3 (Berkeley) 1/21/94
61 */
62
63#ifndef _TIME_H_
64#define _TIME_H_
65
66#include <_types.h>
67#include <sys/cdefs.h>
68#include <_bounds.h>
69#include <Availability.h>
70#include <sys/_types/_clock_t.h>
71#include <sys/_types/_null.h>
72#include <sys/_types/_size_t.h>
73#include <sys/_types/_time_t.h>
74#include <sys/_types/_timespec.h>
75
76_LIBC_SINGLE_BY_DEFAULT()
77
78struct tm {
79 int tm_sec; /* seconds after the minute [0-60] */
80 int tm_min; /* minutes after the hour [0-59] */
81 int tm_hour; /* hours since midnight [0-23] */
82 int tm_mday; /* day of the month [1-31] */
83 int tm_mon; /* months since January [0-11] */
84 int tm_year; /* years since 1900 */
85 int tm_wday; /* days since Sunday [0-6] */
86 int tm_yday; /* days since January 1 [0-365] */
87 int tm_isdst; /* Daylight Savings Time flag */
88 long tm_gmtoff; /* offset from UTC in seconds */
89 char *_LIBC_CSTR tm_zone; /* timezone abbreviation */
90};
91
92#if __DARWIN_UNIX03
93#define CLOCKS_PER_SEC ((clock_t)1000000) /* [XSI] */
94#else /* !__DARWIN_UNIX03 */
95#include <machine/_limits.h> /* Include file containing CLK_TCK. */
96
97#define CLOCKS_PER_SEC ((clock_t)(__DARWIN_CLK_TCK))
98#endif /* __DARWIN_UNIX03 */
99
100#ifndef _ANSI_SOURCE
101extern char *_LIBC_CSTR tzname[_LIBC_COUNT(2)];
102#endif
103
104extern int getdate_err;
105#if __DARWIN_UNIX03
106extern long timezone __DARWIN_ALIAS(timezone);
107#endif /* __DARWIN_UNIX03 */
108extern int daylight;
109
110__BEGIN_DECLS
111char *_LIBC_CSTR asctime(const struct tm *);
112clock_t clock(void) __DARWIN_ALIAS(clock);
113char *_LIBC_CSTR ctime(const time_t *);
114double difftime(time_t, time_t);
115struct tm *getdate(const char *);
116struct tm *gmtime(const time_t *);
117struct tm *localtime(const time_t *);
118time_t mktime(struct tm *) __DARWIN_ALIAS(mktime);
119size_t strftime(char *_LIBC_COUNT(__maxsize) __restrict, size_t __maxsize, const char * __restrict, const struct tm * __restrict) __DARWIN_ALIAS(strftime);
120char *_LIBC_CSTR strptime(const char * __restrict, const char * __restrict, struct tm * __restrict) __DARWIN_ALIAS(strptime);
121time_t time(time_t *);
122
123#ifndef _ANSI_SOURCE
124void tzset(void);
125#endif /* not ANSI */
126
127/* [TSF] Thread safe functions */
128char *_LIBC_CSTR asctime_r(const struct tm * __restrict, char * __restrict _LIBC_COUNT(26));
129char *_LIBC_CSTR ctime_r(const time_t *, char *_LIBC_COUNT(26));
130struct tm *gmtime_r(const time_t * __restrict, struct tm * __restrict);
131struct tm *localtime_r(const time_t * __restrict, struct tm * __restrict);
132
133#if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE))
134time_t posix2time(time_t);
135#if !__DARWIN_UNIX03
136char *_LIBC_CSTR timezone(int, int);
137#endif /* !__DARWIN_UNIX03 */
138void tzsetwall(void);
139time_t time2posix(time_t);
140time_t timelocal(struct tm * const);
141time_t timegm(struct tm * const);
142#endif /* neither ANSI nor POSIX */
143
144#if !defined(_ANSI_SOURCE)
145int nanosleep(const struct timespec *__rqtp, struct timespec *__rmtp) __DARWIN_ALIAS_C(nanosleep);
146#endif
147
148#if !defined(_DARWIN_FEATURE_CLOCK_GETTIME) || _DARWIN_FEATURE_CLOCK_GETTIME != 0
149#if __DARWIN_C_LEVEL >= 199309L
150#if __has_feature(enumerator_attributes)
151#define __CLOCK_AVAILABILITY __OSX_AVAILABLE(10.12) __IOS_AVAILABLE(10.0) __TVOS_AVAILABLE(10.0) __WATCHOS_AVAILABLE(3.0)
152#else
153#define __CLOCK_AVAILABILITY
154#endif
155
156typedef enum {
157_CLOCK_REALTIME __CLOCK_AVAILABILITY = 0,
158#define CLOCK_REALTIME _CLOCK_REALTIME
159_CLOCK_MONOTONIC __CLOCK_AVAILABILITY = 6,
160#define CLOCK_MONOTONIC _CLOCK_MONOTONIC
161#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
162_CLOCK_MONOTONIC_RAW __CLOCK_AVAILABILITY = 4,
163#define CLOCK_MONOTONIC_RAW _CLOCK_MONOTONIC_RAW
164_CLOCK_MONOTONIC_RAW_APPROX __CLOCK_AVAILABILITY = 5,
165#define CLOCK_MONOTONIC_RAW_APPROX _CLOCK_MONOTONIC_RAW_APPROX
166_CLOCK_UPTIME_RAW __CLOCK_AVAILABILITY = 8,
167#define CLOCK_UPTIME_RAW _CLOCK_UPTIME_RAW
168_CLOCK_UPTIME_RAW_APPROX __CLOCK_AVAILABILITY = 9,
169#define CLOCK_UPTIME_RAW_APPROX _CLOCK_UPTIME_RAW_APPROX
170#endif
171_CLOCK_PROCESS_CPUTIME_ID __CLOCK_AVAILABILITY = 12,
172#define CLOCK_PROCESS_CPUTIME_ID _CLOCK_PROCESS_CPUTIME_ID
173_CLOCK_THREAD_CPUTIME_ID __CLOCK_AVAILABILITY = 16
174#define CLOCK_THREAD_CPUTIME_ID _CLOCK_THREAD_CPUTIME_ID
175} clockid_t;
176
177__CLOCK_AVAILABILITY
178int clock_getres(clockid_t __clock_id, struct timespec *__res);
179
180__CLOCK_AVAILABILITY
181int clock_gettime(clockid_t __clock_id, struct timespec *__tp);
182
183#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
184__CLOCK_AVAILABILITY
185__uint64_t clock_gettime_nsec_np(clockid_t __clock_id);
186#endif
187
188__OSX_AVAILABLE(10.12) __IOS_PROHIBITED
189__TVOS_PROHIBITED __WATCHOS_PROHIBITED
190int clock_settime(clockid_t __clock_id, const struct timespec *__tp);
191
192#undef __CLOCK_AVAILABILITY
193#endif /* __DARWIN_C_LEVEL */
194#endif /* _DARWIN_FEATURE_CLOCK_GETTIME */
195
196#if (__DARWIN_C_LEVEL >= __DARWIN_C_FULL) || \
197 (defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L) || \
198 (defined(__cplusplus) && __cplusplus >= 201703L)
199/* ISO/IEC 9899:201x 7.27.2.5 The timespec_get function */
200#define TIME_UTC 1 /* time elapsed since epoch */
201__API_AVAILABLE(macosx(10.15), ios(13.0), tvos(13.0), watchos(6.0))
202int timespec_get(struct timespec *ts, int base);
203#endif
204
205__END_DECLS
206
207#endif /* !_TIME_H_ */