asctime, _wasctime

아티클
04/10/2013

변환 된 tm 시간 구조에 문자열입니다.이러한 함수를 더 안전한 버전을 사용할 수 있습니다. see asctime_s, _wasctime_s.

char *asctime( 
   const struct tm *timeptr 
);
wchar_t *_wasctime( 
   const struct tm *timeptr 
);

매개 변수

timeptr
구조를 날짜/시간입니다.

반환 값

asctime문자 문자열 결과에 대 한 포인터를 반환합니다. _wasctime와이드 문자열 결과 대 한 포인터를 반환합니다.없음 오류 반환 값이입니다.

설명

이러한 함수를 더 안전한 버전을 사용할 수 있습니다. 참조 하십시오 asctime_s, _wasctime_s.

asctime 함수 구조를 문자열에 저장 된 시간을 변환 합니다.timeptr 값에서 일반적으로에 대 한 호출에서 얻은 gmtime 또는 localtime, 모두에 대 한 포인터를 반환 된 tm 구조체에서 정의 된.H.

timeptr 멤버	값
tm_hour	시간 (는 0-23)
tm_isdst	일광 절약 시간이 적용 되는 경우 양수입니다. 일광 절약 시간제가 적용 되지 않는 경우 0입니다. 일광 절약 시간 상태를 알 수 없는 경우 음수입니다.C 런타임 라이브러리 일광 절약 시간제 (DST)의 계산을 구현에 대 한 대한민국의 규칙을 가정 합니다.
tm_mday	월 (1)의
tm_min	분 (0-59입니다)
tm_mon	달 (0–11; 0 = 1 월)
tm_sec	초 (0-59입니다) 1 분 후
tm_wday	요일 (0–6; 0 = 일요일)
tm_yday	일 연도 (0–365; 1 월 1 일 = 0)
tm_year	(현재 연도 1900 뺀) 년

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

생성 되는 문자열 결과 asctime 정확히 26 자 고 폼 Wed Jan 02 02:03:55 1980\n\0.24 시간 형식을 사용 합니다.하면 모든 필드에 있습니다.줄 바꿈 문자 및 null 문자가 문자열의 마지막 두 개의 위치를 차지합니다.asctime단일의 정적으로 할당 된 버퍼를 사용 하 여 반환 문자열을 저장할 수 있습니다.이 함수를 호출할 때마다 이전 호출의 결과 소멸 시킵니다.

_wasctime와이드 문자 버전입니다 asctime._wasctime및 asctime 그렇지을 동일 하 게 작동 합니다.

이러한 함수 매개 변수의 유효성을 검사 합니다.경우 timeptr 는 null 포인터 또는 범위 밖의 값을 포함 하는 경우 잘못 된 매개 변수 처리기를의 설명에 따라 호출 됩니다 매개 변수 유효성 검사.함수 실행 계속할 수 있는지 여부를 반환 NULL 를 설정 하 고 errno 에 EINVAL.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_tasctime	asctime	asctime	_wasctime

요구 사항

루틴	필수 헤더
asctime	<time.h>
_wasctime	<time.h> 또는 <wchar.h>

예제

이 프로그램은 정수 (long)에서 시스템 시간 배치 aclock, 구조로 변환 newtime 및 다음 문자열 형식에 대해 변환 출력, 사용 하는 asctime 함수.

// crt_asctime.c
// compile with: /W3

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

int main( void )
{
    struct tm   *newTime;
    time_t      szClock;

    // Get time in seconds
    time( &szClock );

    // Convert time to struct tm form 
    newTime = localtime( &szClock );

    // Print local time as a string.
    printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
    // Note: asctime is deprecated; consider using asctime_s instead
}