다음을 통해 공유


strftime, wcsftime, _strftime_l, _wcsftime_l

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

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을 제거 합니다.

요구 사항

루틴

필수헤더

strftime

<time.h>

wcsftime

<time.h> 또는 <wchar.h>

_strftime_l

<time.h>

_wcsftime_l

<time.h> 또는 <wchar.h>

추가 호환성 정보를 참조 하십시오. 호환성 소개에서 합니다.

예제

예제를 보려면 시간.

해당 .NET Framework 항목

참고 항목

참조

로캘

시간 관리

문자열 조작 (CRT)

localeconv

setlocale을 _wsetlocale

strcoll 함수

strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l