ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

아티클
06/09/2015

시간 값을 문자열로 변환 하고 현지 표준 시간대 설정을 조정 합니다. 이러한 기능의 더 안전한 버전을 사용할 수 있습니다. 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 이 반환되는 경우:

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

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

설명

ctime 함수는 문자 문자열로 time_t 에 저장된 시간 값을 변환합니다. timer 값은 time, 1970 년 1 월 1 일 자정(00:00)부터 경과 된 초 인 협정 세계시 (UTC)를 반환하는, time 를 호출하여 가져옵니다. 반환 값 문자열은 정확히 26 문자 포함 되고 폼을 가집니다.:

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

24 시간제를 사용 합니다. 모든 필드 너비가 일정합니다. 줄 바꿈 문자('\n') 및 null 문자('\0')가 문자열의 마지막 두 자리를 차지 합니다.

변환 된 문자열은 현지 표준 시간대 설정에 따라 조정할 수 있습니다. 현지 시간 구성에 대한 자세한 정보는 time, _ftime, 및 localtime 함수를 참조하고 시간대 환경 및 전역 변수를 정의하는것에 대한 자세한 정보는 _tzset 함수를 참조하십시오.

ctime 호출은 gmtime 및 localtime 함수에서 사용 되는 정적으로 할당된 단일 버퍼를 수정합니다. 이러한 루틴 중 하나를 호출 할 때마다 이전 호출의 결과를 삭제합니다. ctime 는 asctime 함수를 사용하여 정적 버퍼를 공유합니다. 따라서 ctime 호출은 asctime, localtime, 또는 gmtime . 의 이전 호출의 결과를 파괴합니다.

_wctime 및 _wctime64 는 와이드 문자 문자열에 대한 포인터를 반환하는 ctime 및 _ctime64 의 와이드 문자 버전입니다. 그렇지 않으면 _ctime64, _wctime, 및 _wctime64 은 ctime 와 동일하게 작동합니다.

이러한 함수는 해당 함수 매개 변수의 유효성을 검사합니다. 만약 timer 가 null 포인터이거나 timer 값이 음수인 경우 이러한 함수는 매개 변수 유효성 검사 에 설명 된 것과 같이 잘못된 매개 변수 핸들러를 호출합니다. 실행을 계속할 수 있는 경우 함수는 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> or <wchar.h>
_wctime32	<time.h> or <wchar.h>
_wctime64	<time.h> or <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
}