strftime, wcsftime, _strftime_l, _wcsftime_l

아티클
02/21/2013

시간 문자열의 형식을 지정 합니다.

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr 
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr 
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

매개 변수

strDest
출력 문자열입니다.
maxsize
크기는 strDest 버퍼에서 문자를 측정 (char 또는 wchart_t).
format
컨트롤 서식 문자열입니다.
timeptr
tm데이터 구조입니다.
locale
사용로캘.

반환 값

strftime저장 되는 문자 수를 반환 합니다. strDest 및 wcsftime 해당 너비 문자 수를 반환 합니다.

총 종료 null을 포함 하 여 문자를 경우 두 개 이상의 maxsize, 두 strftime 및 wcsftime 0과의 내용을 반환할 strDest 특별히 정해져 있지 않았습니다.

문자 수가 strDest 리터럴 문자 수가 같지 format 뿐만 아니라 모든 문자가 추가 될 수 있습니다 format 서식 코드를 통해.종료 null 문자열에는반환 값개수가 계산 되지 않습니다.

설명

strftime 및 wcsftime 함수 형식에 tm시간 값에 timeptr 는 제공 된에 따라 format인수하 고 그 결과 버퍼에서 저장소 strDest*.* 최대, maxsize 문자가 문자열에 배치 됩니다.설명 필드는 timeptr구조체를 참조 하십시오 asctime. wcsftime와이드 문자에 해당 하는입니다 strftime. 문자열-포인터인수는 와이드 문자열을 가리킵니다.이러한 함수는 동일 하 게 그렇지 않으면 동작합니다.

[!참고]

이전 버전에서Visual C++ 2005, 설명 하는 설명서는 format매개 변수를 wcsftime데이터 형식으로const wchar_t *, 있지만 실제 구현을 format데이터 형식const char *. 구현에서 format데이터 형식의 이전 및 현재 설명서를, 반영 하기 위해 업데이트 되었습니다 const wchar_t *.

이함수매개 변수의 유효성을 검사 합니다.경우 strDest, format, 또는timeptr null포인터를 경우는 tm데이터 구조에서 해결 timeptr잘못된(예 범위를 벗어난 값을 시간 또는 날짜를 포함 하는 경우), 또는 if는 format 서식코딩하다는잘못된문자열을 포함 하 고의 설명에 따라잘못된매개 변수처리기가 호출 매개 변수 유효성 검사. 실행을 계속 하려면함수는 0 반환 하 고 설정 수 있으면 errno 에 EINVAL.

일반 텍스트 루틴 매핑

TCHAR입니다.H 루틴	_UNICODE 및 _Mbcs가 정의 되지 않았습니다.	_Mbcs가 정의	_Unicode가 정의
_tcsftime	strftime	strftime	wcsftime

format인수구성의 일부 코드입니다. 와 같이 printf, 서식 코드 앞에 백분율 기호 (%).다음으로 시작 하지 않는 문자 % 를 변경 되지 않은 상태로 복사 됩니다 strDest*.*LC_TIME는 현재로캘의범주영향을 미치는의 출력 서식을 strftime. (대 한 자세한 내용은 LC_TIME를 참조 하십시오 setlocale입니다.) 없이 함수는 _l 접미사 사용 현재 설정로캘입니다.버전으로 이러한 함수는 _l 접미사로캘매개 변수변수로 받아 현재 설정 대신 사용 제외 하 고 동일로캘.자세한 내용은 로캘를 참조하십시오.

서식 코드에 대 한 strftime 아래에 나열 됩니다.

%a
약식된 요일 이름
%A
전체 요일 이름
%b
약식된 월 이름
%B
전체 월 이름
%c
로캘대 한 적절 한 날짜 및 시간 표현이
%d
월10진의
%H
24 시간 형식의 시간 (00-23)
%I
12 시간 형식의 시간 (01 – 12)
%j
요일10진
%m
월10진
%M
10진분 (00-59)
%p
현재로캘의 오전입니다.12 시간 형식에 대 한 표시기
%S
두 번째10진(00-59)
%U
주의 첫째 요일 일요일10진연도의 주 (00-53)
%w
요일10진(0-6. 일요일이 0 임)
%W
주의 첫째 요일이 월요일10진연도의 주 (00-53)
%x
현재로캘대 한 날짜 표현
%X
현재로캘에 대 한 시간 표현
%y
10진세기를 하지 않고 1 년 (00-99)
%Y
연도10진세기를
%z, %Z
시간영역이름 또는 시간영역약어에 따라 레지스트리 설정입니다. 표준영역를 알 수 없으면 문자가 없습니다
%%
백분율 기호

에 printf함수를 #플래그를 지정하다는 서식코딩하다접두어 될 수 있습니다. 이대/소문자에서 서식코딩하다의 의미는 다음과 같이 변경 됩니다.

코드 형식	의미
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%	#플래그를 지정하다는 무시 됩니다.
%#c	긴 날짜 및 시간 표현이 현재로캘에 대 한 적절 한입니다.예를 들어: "화요일, 3 월 14, 1995, 12시 41분: 29".
%#x	현재로캘에 적절 한 자세한 날짜 표현입니다.예를 들어: "화요일, 3 월 14, 1995".
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y	(있는 경우) 앞에 오는 0을 제거 합니다.