_time.h (8243B) - Raw
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 78 struct 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 101 extern char *_LIBC_CSTR tzname[_LIBC_COUNT(2)]; 102 #endif 103 104 extern int getdate_err; 105 #if __DARWIN_UNIX03 106 extern long timezone __DARWIN_ALIAS(timezone); 107 #endif /* __DARWIN_UNIX03 */ 108 extern int daylight; 109 110 __BEGIN_DECLS 111 char *_LIBC_CSTR asctime(const struct tm *); 112 clock_t clock(void) __DARWIN_ALIAS(clock); 113 char *_LIBC_CSTR ctime(const time_t *); 114 double difftime(time_t, time_t); 115 struct tm *getdate(const char *); 116 struct tm *gmtime(const time_t *); 117 struct tm *localtime(const time_t *); 118 time_t mktime(struct tm *) __DARWIN_ALIAS(mktime); 119 size_t strftime(char *_LIBC_COUNT(__maxsize) __restrict, size_t __maxsize, const char * __restrict, const struct tm * __restrict) __DARWIN_ALIAS(strftime); 120 char *_LIBC_CSTR strptime(const char * __restrict, const char * __restrict, struct tm * __restrict) __DARWIN_ALIAS(strptime); 121 time_t time(time_t *); 122 123 #ifndef _ANSI_SOURCE 124 void tzset(void); 125 #endif /* not ANSI */ 126 127 /* [TSF] Thread safe functions */ 128 char *_LIBC_CSTR asctime_r(const struct tm * __restrict, char * __restrict _LIBC_COUNT(26)); 129 char *_LIBC_CSTR ctime_r(const time_t *, char *_LIBC_COUNT(26)); 130 struct tm *gmtime_r(const time_t * __restrict, struct tm * __restrict); 131 struct tm *localtime_r(const time_t * __restrict, struct tm * __restrict); 132 133 #if !defined(_ANSI_SOURCE) && (!defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)) 134 time_t posix2time(time_t); 135 #if !__DARWIN_UNIX03 136 char *_LIBC_CSTR timezone(int, int); 137 #endif /* !__DARWIN_UNIX03 */ 138 void tzsetwall(void); 139 time_t time2posix(time_t); 140 time_t timelocal(struct tm * const); 141 time_t timegm(struct tm * const); 142 #endif /* neither ANSI nor POSIX */ 143 144 #if !defined(_ANSI_SOURCE) 145 int 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 156 typedef 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 178 int clock_getres(clockid_t __clock_id, struct timespec *__res); 179 180 __CLOCK_AVAILABILITY 181 int 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 190 int 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)) 202 int timespec_get(struct timespec *ts, int base); 203 #endif 204 205 __END_DECLS 206 207 #endif /* !_TIME_H_ */