ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64

  • 아티클

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

구문

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

매개 변수

sourceTime
변환할 저장된 시간에 대한 포인터입니다.

반환 값

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

  • sourceTime은 1970년 1월 1일(UTC) 자정 이전의 날짜를 나타냅니다.

  • UTC 2038년 1월 18일 23:59:59 이후의 날짜를 사용 _ctime32 하거나 _wctime32sourceTime 나타냅니다.

  • UTC 3000년 sourceTime 12월 31일 23:59:59 이후의 날짜를 사용 _ctime64 하거나 _wctime64나타냅니다.

ctime은 _ctime64로 계산되는 인라인 함수이며 time_t는 __time64_t와 동일합니다. 컴파일러에서 time_t 를 이전의 32비트 time_t로 해석하게 해야 하는 경우 _USE_32BIT_TIME_T를 정의할 수 있습니다. 이 매크로는 ctime 을 계산합니다 _ctime32. 2038년 1월 18일 이후에 애플리케이션이 실패할 수 있으며 64비트 플랫폼에서는 허용되지 않으므로 사용하지 않는 것이 좋습니다.

설명

이 함수는 ctime 값으로 time_t 저장된 시간 값을 문자열로 변환합니다. 값은 sourceTime 일반적으로 자정(00:00:00), 1970년 1월 1일 UTC(협정 세계시) 이후 경과된 시간(초)을 반환하는 호출 time에서 가져옵니다. 반환 값 문자열은 정확히 26자를 포함하며 그 형식은 다음과 같습니다.

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

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

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

ctime을 호출하면 gmtime 및 localtime 함수에서 사용하는 단일 정적 할당 버퍼가 수정됩니다. 이러한 루틴 중 하나를 호출할 때마다 이전 호출의 결과가 삭제됩니다. ctime은 asctime 함수와 정적 버퍼를 공유합니다. 따라서 ctime을 호출하면 asctime, localtime 또는 gmtime에 대한 이전 호출의 결과가 삭제됩니다.

_wctime 및 _wctime64는 ctime 및 _ctime64의 와이드 문자 버전이며, 와이드 문자 문자열에 대한 포인터를 반환합니다. 그 외에는 _ctime64, _wctime 및 _wctime64가 ctime과 동일하게 작동합니다.

이러한 함수는 해당 함수 매개 변수의 유효성을 검사합니다. null 포인터이거나 값이 sourceTime 음수이면 sourceTime 이러한 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다. 계속해서 실행하도록 허용된 경우 이 함수는 NULL을 반환하며 errno를 EINVAL로 설정합니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

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
}

The time is Wed Feb 13 16:04:43 2002

참고 항목

시간 관리
asctime, _wasctime
ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s
_ftime, _ftime32, _ftime64
gmtime, _gmtime32, _gmtime64
localtime, _localtime32, _localtime64
time, _time32, _time64