ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

아티클
04/10/2013

시간 값을 문자열로 변환 하 고 현지 표준 시간대 설정을 조정 합니다.이러한 함수를 더 안전한 버전을 사용할 수 있습니다. see ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s.

char *ctime( 
   const time_t *timer 
);
char *_ctime32( 
   const __time32_t *timer )
;
char *_ctime64( 
   const __time64_t *timer )
;
wchar_t *_wctime( 
   const time_t *timer 
);
wchar_t *_wctime32( 
   const __time32_t *timer
);
wchar_t *_wctime64( 
   const __time64_t *timer 
);

매개 변수

timer
저장 된 시간에 대 한 포인터입니다.

반환 값

문자 문자열 결과에 대 한 포인터입니다.NULL경우에 반환 됩니다.

timeUTC 1970 년 1 월 1 일 자정 이전 날짜를 나타냅니다.
사용 하는 경우 _ctime32 또는 _wctime32 및 time 03시 14분: 07 2038 1 월 19 일 후의 날짜를 나타냅니다.
사용 하는 경우 _ctime64 또는 _wctime64 및 time 후 23시 59분: 59, 3000, 12 월 31 UTC 날짜를 나타냅니다.

ctime산출 하는 인라인 함수 이며 _ctime64 및 time_t 입니다 __time64_t.해석 하도록 컴파일러를 강제 하는 경우 time_t 로 이전 32 비트 time_t를 정의할 수 있습니다 _USE_32BIT_TIME_T.그러면 이렇게 하면 ctime 평가 _ctime32.2038 년 1 월 18 일 이후 응용 프로그램이 실패 하 고 64 비트 플랫폼에서 사용할 수 없습니다 때문에 권장 되지 않습니다.

설명

ctime 함수 변환으로 저장 된 시간 값은 time_t 를 문자 문자열 값입니다.timer 값에서 일반적으로에 대 한 호출에서 얻은 시간, 반환 초 자정 이후 경과 된 시간 (00: 00: 00), 1970 년 1 월 1 일 협정 세계시 (UTC)입니다.반환 값 문자열 정확히 26 자과 양식이 있습니다.

Wed Jan 02 02:03:55 1980\n\0

24 시간 형식을 사용 합니다.하면 모든 필드에 있습니다.줄 바꿈 문자 ('\n') 및 null 문자 ('\ 0')는 문자열의 마지막 두 개의 위치를 차지합니다.

변환 된 문자열은 현지 표준 시간대 설정에 따라 수도 조정 됩니다.참조는 time, _ftime, 및 로컬 시간 함수는 현지 시간을 구성 하는 방법에 대 한 하는 _tzset 시간대 환경 및 전역 변수를 정의 하는 방법에 대 한 자세한 내용은 함수입니다.

호출을 ctime 수정 하 여 사용 되는 한 정적으로 할당 된 버퍼는 gmtime 및 localtime 함수입니다.이러한 루틴 중 하나를 호출할 때마다 이전 호출의 결과 소멸 시킵니다.ctime정적 버퍼를 공유의 asctime 함수입니다.따라서 호출 ctime 있는 이전 호출의 결과 소멸 asctime, localtime, 또는 gmtime.

_wctime및 _wctime64 의 와이드 문자 버전입니다 ctime 및 _ctime64. 와이드 문자열에 대 한 포인터를 반환합니다.Otherwise, _ctime64, _wctime, and _wctime64 behave identically to ctime.

이러한 함수 매개 변수의 유효성을 검사 합니다.경우 timer 은 null 포인터입니다. 타이머 값이 음수 이면 이러한 함수는 잘못 된 매개 변수 처리기의 설명에 따라 호출 하거나 매개 변수 유효성 검사.실행 계속 될 수 있습니다 경우에 함수 반환 NULL 를 설정 하 고 errno 에 EINVAL.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_tctime	ctime	ctime	_wctime
_tctime32	_ctime32	_ctime32	_wctime32
_tctime64	_ctime64	_ctime64	_wctime64

요구 사항

루틴	필수 헤더
ctime	<time.h>
_ctime32	<time.h>
_ctime64	<time.h>
_wctime	<time.h> 또는 <wchar.h>
_wctime32	<time.h> 또는 <wchar.h>
_wctime64	<time.h> 또는 <wchar.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
 * time in _time64_t form, then uses ctime to
 * display the time in string form.
 */

#include <time.h>
#include <stdio.h>

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}