/*** *time.h - definitions/declarations for time routines * * Copyright (c) Microsoft Corporation. All rights reserved. * *Purpose: * This file has declarations of time routines and defines * the structure returned by the localtime and gmtime routines and * used by asctime. * [ANSI/System V] * * [Public] * ****/ #pragma once #ifndef _INC_TIME #define _INC_TIME #include #if !defined (_WIN32) #error ERROR: Only Win32 target supported! #endif /* !defined (_WIN32) */ /* * Currently, all MS C compilers for Win32 platforms default to 8 byte * alignment. */ #pragma pack(push,_CRT_PACKING) #ifdef __cplusplus extern "C" { #endif /* __cplusplus */ #ifdef _CRTBLD #include #endif /* _CRTBLD */ #if !defined (_W64) #if !defined (__midl) && (defined (_X86_) || defined (_M_IX86)) #define _W64 __w64 #else /* !defined (__midl) && (defined (_X86_) || defined (_M_IX86)) */ #define _W64 #endif /* !defined (__midl) && (defined (_X86_) || defined (_M_IX86)) */ #endif /* !defined (_W64) */ /* Define _CRTIMP */ #ifndef _CRTIMP #if defined(CRTDLL) && defined(_CRTBLD) #define _CRTIMP __declspec(dllexport) #else /* defined(CRTDLL) && defined(_CRTBLD) */ #ifdef _DLL #define _CRTIMP __declspec(dllimport) #else /* _DLL */ #define _CRTIMP #endif /* _DLL */ #endif /* defined(CRTDLL) && defined(_CRTBLD) */ #endif /* _CRTIMP */ #ifndef _WCHAR_T_DEFINED typedef unsigned short wchar_t; #define _WCHAR_T_DEFINED #endif /* _WCHAR_T_DEFINED */ #ifndef _TIME32_T_DEFINED typedef _W64 long __time32_t; /* 32-bit time value */ #define _TIME32_T_DEFINED #endif /* _TIME32_T_DEFINED */ #ifndef _TIME64_T_DEFINED typedef __int64 __time64_t; /* 64-bit time value */ #define _TIME64_T_DEFINED #endif /* _TIME64_T_DEFINED */ #ifndef _TIME_T_DEFINED #ifdef _USE_32BIT_TIME_T typedef __time32_t time_t; /* time value */ #else /* _USE_32BIT_TIME_T */ typedef __time64_t time_t; /* time value */ #endif /* _USE_32BIT_TIME_T */ #define _TIME_T_DEFINED /* avoid multiple def's of time_t */ #endif /* _TIME_T_DEFINED */ #ifndef _CLOCK_T_DEFINED typedef long clock_t; #define _CLOCK_T_DEFINED #endif /* _CLOCK_T_DEFINED */ #ifndef _SIZE_T_DEFINED #ifdef _WIN64 typedef unsigned __int64 size_t; #else /* _WIN64 */ typedef _W64 unsigned int size_t; #endif /* _WIN64 */ #define _SIZE_T_DEFINED #endif /* _SIZE_T_DEFINED */ /* Define NULL pointer value */ #ifndef NULL #ifdef __cplusplus #define NULL 0 #else /* __cplusplus */ #define NULL ((void *)0) #endif /* __cplusplus */ #endif /* NULL */ #ifndef _TM_DEFINED struct tm { int tm_sec; /* seconds after the minute - [0,59] */ int tm_min; /* minutes after the hour - [0,59] */ int tm_hour; /* hours since midnight - [0,23] */ int tm_mday; /* day of the month - [1,31] */ int tm_mon; /* months since January - [0,11] */ int tm_year; /* years since 1900 */ int tm_wday; /* days since Sunday - [0,6] */ int tm_yday; /* days since January 1 - [0,365] */ int tm_isdst; /* daylight savings time flag */ }; #define _TM_DEFINED #endif /* _TM_DEFINED */ /* Clock ticks macro - ANSI version */ #define CLOCKS_PER_SEC 1000 /* Extern declarations for the global variables used by the ctime family of * routines. */ #ifdef _CRTBLD #if defined (_DLL) && defined (_M_IX86) /* Retained for compatibility with VC++ 5.0 and earlier versions */ _CRTIMP int * __cdecl __p__daylight(void); _CRTIMP long * __cdecl __p__dstbias(void); _CRTIMP long * __cdecl __p__timezone(void); _CRTIMP char ** __cdecl __p__tzname(void); #endif /* defined (_DLL) && defined (_M_IX86) */ #endif /* _CRTBLD */ /* non-zero if daylight savings time is used */ _Check_return_ _CRT_INSECURE_DEPRECATE_GLOBALS(_get_daylight) _CRTIMP int* __cdecl __daylight(void); #define _daylight (*__daylight()) /* offset for Daylight Saving Time */ _Check_return_ _CRT_INSECURE_DEPRECATE_GLOBALS(_get_dstbias) _CRTIMP long* __cdecl __dstbias(void); #define _dstbias (*__dstbias()) /* difference in seconds between GMT and local time */ _Check_return_ _CRT_INSECURE_DEPRECATE_GLOBALS(_get_timezone) _CRTIMP long* __cdecl __timezone(void); #define _timezone (*__timezone()) /* standard/daylight savings time zone names */ _Check_return_ _Deref_ret_z_ _CRT_INSECURE_DEPRECATE_GLOBALS(_get_tzname) _CRTIMP char ** __cdecl __tzname(void); #define _tzname (__tzname()) _CRTIMP errno_t __cdecl _get_daylight(_Out_ int * _Daylight); _CRTIMP errno_t __cdecl _get_dstbias(_Out_ long * _Daylight_savings_bias); _CRTIMP errno_t __cdecl _get_timezone(_Out_ long * _Timezone); _CRTIMP errno_t __cdecl _get_tzname(_Out_ size_t *_ReturnValue, _Out_writes_z_(_SizeInBytes) char *_Buffer, _In_ size_t _SizeInBytes, _In_ int _Index); #ifdef _CRTBLD _DEFINE_SET_FUNCTION(_set_daylight, int, _daylight) _DEFINE_SET_FUNCTION(_set_dstbias, long, _dstbias) _DEFINE_SET_FUNCTION(_set_timezone, long, _timezone) #endif /* _CRTBLD */ /* Function prototypes */ _Check_return_ _CRT_INSECURE_DEPRECATE(asctime_s) _CRTIMP char * __cdecl asctime(_In_ const struct tm * _Tm); #if __STDC_WANT_SECURE_LIB__ _Check_return_wat_ _CRTIMP errno_t __cdecl asctime_s(_Out_writes_(_SizeInBytes) _Post_readable_size_(26) char *_Buf, _In_ size_t _SizeInBytes, _In_ const struct tm * _Tm); #endif /* __STDC_WANT_SECURE_LIB__ */ __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1(errno_t, asctime_s, _Post_readable_size_(26) char, _Buffer, _In_ const struct tm *, _Time) _CRT_INSECURE_DEPRECATE(_ctime32_s) _CRTIMP char * __cdecl _ctime32(_In_ const __time32_t * _Time); _CRTIMP errno_t __cdecl _ctime32_s(_Out_writes_(_SizeInBytes) _Post_readable_size_(26) char *_Buf, _In_ size_t _SizeInBytes, _In_ const __time32_t *_Time); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1(errno_t, _ctime32_s, _Post_readable_size_(26) char, _Buffer, _In_ const __time32_t *, _Time) _Check_return_ _CRTIMP clock_t __cdecl clock(void); _CRTIMP double __cdecl _difftime32(_In_ __time32_t _Time1, _In_ __time32_t _Time2); _Check_return_ _CRT_INSECURE_DEPRECATE(_gmtime32_s) _CRTIMP struct tm * __cdecl _gmtime32(_In_ const __time32_t * _Time); _Check_return_wat_ _CRTIMP errno_t __cdecl _gmtime32_s(_In_ struct tm *_Tm, _In_ const __time32_t * _Time); _CRT_INSECURE_DEPRECATE(_localtime32_s) _CRTIMP struct tm * __cdecl _localtime32(_In_ const __time32_t * _Time); _CRTIMP errno_t __cdecl _localtime32_s(_Out_ struct tm *_Tm, _In_ const __time32_t * _Time); _CRTIMP size_t __cdecl strftime(_Out_writes_z_(_SizeInBytes) char * _Buf, _In_ size_t _SizeInBytes, _In_z_ _Printf_format_string_ const char * _Format, _In_ const struct tm * _Tm); _CRTIMP size_t __cdecl _strftime_l(_Pre_notnull_ _Post_z_ char *_Buf, _In_ size_t _Max_size, _In_z_ _Printf_format_string_ const char * _Format, _In_ const struct tm *_Tm, _In_opt_ _locale_t _Locale); _Check_return_wat_ _CRTIMP errno_t __cdecl _strdate_s(_Out_writes_(_SizeInBytes) _Post_readable_size_(9) char *_Buf, _In_ size_t _SizeInBytes); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_0(errno_t, _strdate_s, _Post_readable_size_(9) char, _Buffer) __DEFINE_CPP_OVERLOAD_STANDARD_FUNC_0_0(char *, __RETURN_POLICY_DST, _CRTIMP, _strdate, _Out_writes_z_(9), char, _Buffer) _Check_return_wat_ _CRTIMP errno_t __cdecl _strtime_s(_Out_writes_(_SizeInBytes) _Post_readable_size_(9) char *_Buf , _In_ size_t _SizeInBytes); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_0(errno_t, _strtime_s, _Post_readable_size_(9) char, _Buffer) __DEFINE_CPP_OVERLOAD_STANDARD_FUNC_0_0(char *, __RETURN_POLICY_DST, _CRTIMP, _strtime, _Out_writes_z_(9), char, _Buffer) _CRTIMP __time32_t __cdecl _time32(_Out_opt_ __time32_t * _Time); _CRTIMP __time32_t __cdecl _mktime32(_Inout_ struct tm * _Tm); _CRTIMP __time32_t __cdecl _mkgmtime32(_Inout_ struct tm * _Tm); #ifdef _CRT_USE_WINAPI_FAMILY_DESKTOP_APP _CRTIMP void __cdecl _tzset(void); #endif /* _CRT_USE_WINAPI_FAMILY_DESKTOP_APP */ _Check_return_ _CRTIMP double __cdecl _difftime64(_In_ __time64_t _Time1, _In_ __time64_t _Time2); _CRT_INSECURE_DEPRECATE(_ctime64_s) _CRTIMP char * __cdecl _ctime64(_In_ const __time64_t * _Time); _CRTIMP errno_t __cdecl _ctime64_s(_Out_writes_z_(_SizeInBytes) char *_Buf, _In_ size_t _SizeInBytes, _In_ const __time64_t * _Time); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1(errno_t, _ctime64_s, char, _Buffer, _In_ const __time64_t *, _Time) _CRT_INSECURE_DEPRECATE(_gmtime64_s) _CRTIMP struct tm * __cdecl _gmtime64(_In_ const __time64_t * _Time); _CRTIMP errno_t __cdecl _gmtime64_s(_Out_ struct tm *_Tm, _In_ const __time64_t *_Time); _CRT_INSECURE_DEPRECATE(_localtime64_s) _CRTIMP struct tm * __cdecl _localtime64(_In_ const __time64_t * _Time); _CRTIMP errno_t __cdecl _localtime64_s(_Out_ struct tm *_Tm, _In_ const __time64_t *_Time); _CRTIMP __time64_t __cdecl _mktime64(_Inout_ struct tm * _Tm); _CRTIMP __time64_t __cdecl _mkgmtime64(_Inout_ struct tm * _Tm); _CRTIMP __time64_t __cdecl _time64(_Out_opt_ __time64_t * _Time); #ifdef _CRT_USE_WINAPI_FAMILY_DESKTOP_APP /* The Win32 API GetLocalTime and SetLocalTime should be used instead. */ _CRT_OBSOLETE(GetLocalTime) unsigned __cdecl _getsystime(_Out_ struct tm * _Tm); _CRT_OBSOLETE(SetLocalTime) unsigned __cdecl _setsystime(_In_ struct tm * _Tm, unsigned _MilliSec); #endif /* _CRT_USE_WINAPI_FAMILY_DESKTOP_APP */ #ifndef _SIZE_T_DEFINED typedef unsigned int size_t; #define _SIZE_T_DEFINED #endif /* _SIZE_T_DEFINED */ #ifndef _WTIME_DEFINED /* wide function prototypes, also declared in wchar.h */ _CRT_INSECURE_DEPRECATE(_wasctime_s) _CRTIMP wchar_t * __cdecl _wasctime(_In_ const struct tm * _Tm); _CRTIMP errno_t __cdecl _wasctime_s(_Out_writes_(_SizeInWords) _Post_readable_size_(26) wchar_t *_Buf, _In_ size_t _SizeInWords, _In_ const struct tm * _Tm); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1(errno_t, _wasctime_s, _Post_readable_size_(26) wchar_t, _Buffer, _In_ const struct tm *, _Time) _CRT_INSECURE_DEPRECATE(_wctime32_s) _CRTIMP wchar_t * __cdecl _wctime32(_In_ const __time32_t *_Time); _CRTIMP errno_t __cdecl _wctime32_s(_Out_writes_(_SizeInWords) _Post_readable_size_(26) wchar_t* _Buf, _In_ size_t _SizeInWords, _In_ const __time32_t * _Time); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1(errno_t, _wctime32_s, _Post_readable_size_(26) wchar_t, _Buffer, _In_ const __time32_t *, _Time) _CRTIMP size_t __cdecl wcsftime(_Out_writes_z_(_SizeInWords) wchar_t * _Buf, _In_ size_t _SizeInWords, _In_z_ _Printf_format_string_ const wchar_t * _Format, _In_ const struct tm * _Tm); _CRTIMP size_t __cdecl _wcsftime_l(_Out_writes_z_(_SizeInWords) wchar_t * _Buf, _In_ size_t _SizeInWords, _In_z_ _Printf_format_string_ const wchar_t *_Format, _In_ const struct tm *_Tm, _In_opt_ _locale_t _Locale); _CRTIMP errno_t __cdecl _wstrdate_s(_Out_writes_(_SizeInWords) _Post_readable_size_(9) wchar_t * _Buf, _In_ size_t _SizeInWords); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_0(errno_t, _wstrdate_s, _Post_readable_size_(9) wchar_t, _Buffer) __DEFINE_CPP_OVERLOAD_STANDARD_FUNC_0_0(wchar_t *, __RETURN_POLICY_DST, _CRTIMP, _wstrdate, _Out_writes_z_(9), wchar_t, _Buffer) _CRTIMP errno_t __cdecl _wstrtime_s(_Out_writes_(_SizeInWords) _Post_readable_size_(9) wchar_t * _Buf, _In_ size_t _SizeInWords); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_0(errno_t, _wstrtime_s, _Post_readable_size_(9) wchar_t, _Buffer) __DEFINE_CPP_OVERLOAD_STANDARD_FUNC_0_0(wchar_t *, __RETURN_POLICY_DST, _CRTIMP, _wstrtime, _Out_writes_z_(9), wchar_t, _Buffer) _CRT_INSECURE_DEPRECATE(_wctime64_s) _CRTIMP wchar_t * __cdecl _wctime64(_In_ const __time64_t * _Time); _CRTIMP errno_t __cdecl _wctime64_s(_Out_writes_(_SizeInWords) _Post_readable_size_(26) wchar_t* _Buf, _In_ size_t _SizeInWords, _In_ const __time64_t *_Time); __DEFINE_CPP_OVERLOAD_SECURE_FUNC_0_1(errno_t, _wctime64_s, _Post_readable_size_(26) wchar_t, _Buffer, _In_ const __time64_t *, _Time) #if !defined (RC_INVOKED) && !defined (__midl) #include #endif /* !defined (RC_INVOKED) && !defined (__midl) */ #define _WTIME_DEFINED #endif /* _WTIME_DEFINED */ #if !defined (RC_INVOKED) && !defined (__midl) #include #endif /* !defined (RC_INVOKED) && !defined (__midl) */ #if !__STDC__ /* Non-ANSI names for compatibility */ #define CLK_TCK CLOCKS_PER_SEC /* daylight, timezone, and tzname are not available under /clr:pure. Please use _daylight, _timezone, and _tzname or _get_daylight, _get_timezone, and _get_tzname instead. */ #if !defined (_M_CEE_PURE) _CRT_INSECURE_DEPRECATE_GLOBALS(_get_daylight) _CRTIMP extern int daylight; _CRT_INSECURE_DEPRECATE_GLOBALS(_get_timezone) _CRTIMP extern long timezone; _CRT_INSECURE_DEPRECATE_GLOBALS(_get_tzname) _CRTIMP extern char * tzname[2]; #endif /* !defined (_M_CEE_PURE) */ #ifdef _CRT_USE_WINAPI_FAMILY_DESKTOP_APP _CRT_NONSTDC_DEPRECATE(_tzset) _CRTIMP void __cdecl tzset(void); #endif /* _CRT_USE_WINAPI_FAMILY_DESKTOP_APP */ #endif /* !__STDC__ */ #ifdef __cplusplus } #endif /* __cplusplus */ #pragma pack(pop) #endif /* _INC_TIME */