다음을 통해 공유


asctime, _wasctime

tm 시간 구조체를 문자열로 변환합니다. 이러한 함수의 더 안전한 버전을 사용할 수 있습니다. 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 일반적으로 TIME.H에 정의된 구조체에 gmtime 대한 포인터를 반환하는 tm 호출 또는 localtime호출에서 가져옵니다.

timeptr 멤버
tm_hour 자정 이후의 시간(0-23)
tm_isdst 일광 절약 시간이 적용되는 경우 양수입니다. 일광 절약 시간이 적용되지 않으면 0입니다. 일광 절약 시간 상태를 알 수 없는 경우 음수입니다. C 런타임 라이브러리에서는 DST(일광 절약 시간) 계산 구현을 위한 미국의 규칙이 사용된다고 가정합니다.
tm_mday 날짜(1-31)
tm_min 시간 후 분(0-59)
tm_mon 월(0-11; 1월 = 0)
tm_sec 분 후 초(0-59)
tm_wday 요일(0-6; 일요일 = 0)
tm_yday 연중 일(0-365; 1월 1일 = 0)
tm_year 연도(현재 연도 빼기 1900)

현지 시간을 구성하는 방법에 대한 자세한 내용은 , _ftimelocaltime 함수를 참조time하세요. 표준 시간대 환경 및 전역 변수를 정의하는 방법에 대한 자세한 내용은 함수를 _tzset 참조하세요.

asctime에 의해 생성된 문자열 결과는 정확히 26자를 포함하며 Wed Jan 2 02:03:55 1980\n\0 형식을 갖습니다. 24시간제가 사용됩니다. 모든 필드에는 상수 너비가 있습니다. 줄 바꿈 문자 및 null 문자는 문자열의 마지막 두 자리를 차지합니다. asctime은 정적으로 할당된 단일 버퍼를 사용하여 반환 문자열을 보관합니다. 이 함수를 호출할 때마다 이전 호출의 결과가 삭제됩니다.

_wasctime 는 와이드 문자 버전의 asctime이고, 그렇지 않으면 .와 동일하게 asctime동작합니다.

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

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

일반 텍스트 루틴 매핑

TCHAR.H 루틴 _UNICODE_MBCS 정의되지 않음 정의된 _MBCS 정의된 _UNICODE
_tasctime asctime asctime _wasctime

요구 사항

루틴에서 반환된 값 필수 헤더
asctime <time.h>
_wasctime <time.h> 또는 <wchar.h>

예시

이 프로그램은 시스템 시간을 긴 정 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
}
Current date and time: Sun Feb  3 11:38:58 2002

참고 항목

시간 관리
ctime, _ctime32, _ctime64, _wctime, _wctime32_wctime64
_ftime, , _ftime32_ftime64
gmtime, , _gmtime32_gmtime64
localtime, , _localtime32_localtime64
time, , _time32_time64
_tzset
asctime_s, _wasctime_s