COleDateTimeSpan::Format

아티클
02/21/2013

서식이 지정 된 문자열을 생성 하는 COleDateTimeSpan 개체입니다.

CString Format(
   LPCTSTR pFormat 
) const;
CString Format(
   UINT nID 
) const;

매개 변수

pFormat
서식 문자열에 유사한는 printf 문자열의 형식을 지정 합니다.서식 코드 앞에 % (%) 서명, 해당 여 바뀝니다 COleDateTimeSpan 구성 요소.형식 문자열에 다른 문자 그대로 반환 된 문자열에 복사 됩니다.값 및 형식 지정 코드에 대 한 의미 형식 는 다음과 같습니다.
- %H 현재 날짜 시간
- %M 현재 시간 (분)
- %S 현재 분에서 초
- % % 백분율 기호
위에 나열 된 네 가지 서식 코드 형식을 허용 하는 유일한 코드입니다.
nID
컨트롤 서식 문자열의 리소스 ID입니다.

반환 값

A CString 는 서식이 지정 된 날짜/시간 범위 값을 포함 합니다.

설명

시간 범위 값의 서식이 지정 된 표현을 만들려면이 함수를 호출 합니다.경우이 상태 COleDateTimeSpan 개체는 null, 빈 문자열 반환 값입니다.상태가 올바르지 않으면 반환 문자열 문자열 리소스가 지정 된 IDS_INVALID_DATETIMESPAN.

폼이이 함수에 대 한 간략 한 설명은 다음과 같습니다.

Format( pFormat )
이 폼 값에 백분율 기호 (%)를 앞에 특수 서식 코드를 포함 하는 형식 문자열을 사용 하 여 서식을 설정 하에서 printf.형식 문자열 매개 변수로 함수에 전달 됩니다.
Format( nID )
이 폼 값에 백분율 기호 (%)를 앞에 특수 서식 코드를 포함 하는 형식 문자열을 사용 하 여 서식을 설정 하에서 printf.서식 문자열 리소스입니다.이 문자열 리소스의 ID는 매개 변수로 전달 됩니다.

예제

// get the current time
COleDateTime tmStart = COleDateTime::GetCurrentTime();

// waste some time
CString str;
::Sleep(3000);

// get the current time again
COleDateTime tmFinish = COleDateTime::GetCurrentTime();

// find the difference
COleDateTimeSpan tmSpan = tmFinish - tmStart;

// tell the user
str = tmSpan.Format(_T("%S seconds elapsed"));
_tprintf_s(_T("%s\n"), (LPCTSTR) str);