다음을 통해 공유


COleDateTime::Format

날짜 및 시간 값의 서식이 지정 된 표현을 만듭니다.

CString Format(
   DWORD dwFlags = 0,
   LCID lcid = LANG_USER_DEFAULT
) const;
CString Format(
   LPCTSTR lpszFormat 
) const;
CString Format(
   UINT nFormatID 
) const;

매개 변수

  • dwFlags
    로캘 플래그 중 하나를 나타냅니다.

    • LOCALE_NOUSEROVERRIDE시스템 기본 로케일 설정 사용자 정의 설정 대신 사용 됩니다.

    • VAR_TIMEVALUEONLY날짜 부분 구문 분석 중에 무시 됩니다.

    • VAR_DATEVALUEONLY시간 부분 구문 분석 중에 무시 됩니다.

  • lcid
    변환에 사용할 로캘 ID를 나타냅니다.언어 식별자에 대 한 자세한 내용은 언어 식별자.

  • lpszFormat
    유사한는 서식 문자열의 printf 문자열의 형식을 지정 합니다.% 정도 앞에 코드 서식을 (%)에 서명 하 고 해당 대체 됩니다 COleDateTime 구성 요소.서식 지정 문자열에 다른 문자 그대로 반환 되는 문자열에 복사 됩니다.런타임 함수 참조 strftime 에 대 한 자세한 내용은.값 및 형식 지정 코드에 대 한 의미 Format 입니다.

    • %H현재 날짜 시간

    • %M현재 시간 (분)

    • %S현재 분 (초)

    • **%%**백분율 기호

  • nFormatID
    컨트롤 서식 문자열에 대 한 리소스 ID입니다.

반환 값

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

설명

경우이의 상태를 COleDateTime 개체는 null, 빈 문자열 반환 값입니다.상태가 잘못 된 경우 반환 문자열에서 문자열 리소스를 지정 된 ATL_IDS_DATETIME_INVALID.

이 함수에 대 한 세 가지 형태에 대 한 간단한 설명을 다음과 같습니다.

  • Format( dwFlags, lcid)
    이 폼 값 (로캘 Id) 언어 사양을 사용 하 여 날짜 및 시간에 대 한 서식.기본 매개 변수를 사용 하 여이 양식에 날짜와 시간을 시간 부분 0 (자정), 어떤 경우에는 날짜를 인쇄 합니다 이거나 날짜 부분 (30 1899 년 12 월), 0가 아니면 어떤 경우는 시간 인쇄에서 인쇄 됩니다.날짜 및 시간 값이 0 (30 1899 년 12 월, 자정) 이면 기본 매개 변수가이 있는 자정을 인쇄 됩니다.

  • Format( lpszFormat)
    이 폼 값에 백분율 기호 (%)를 앞에 특수 서식 코드를 포함 하는 형식 문자열을 사용 하 여에서 같이 형식 printf.형식 문자열을 매개 변수로 함수에 전달 됩니다.형식 지정 코드에 대 한 자세한 내용은 strftime, wcsftime 런타임 라이브러리 참조에서.

  • Format( nFormatID)
    이 폼 값에 백분율 기호 (%)를 앞에 특수 서식 코드를 포함 하는 형식 문자열을 사용 하 여에서 같이 형식 printf.서식 지정 문자열 리소스입니다.문자열 리소스의 ID는 매개 변수로 전달 됩니다.형식 지정 코드에 대 한 자세한 내용은 strftime, wcsftime 에 있는 런타임 라이브러리 참조.

예제

COleDateTime t(1999, 3, 19, 22, 15, 0);

CString str = t.Format(_T("%A, %B %d, %Y"));
ASSERT(str == _T("Friday, March 19, 1999"));   

요구 사항

헤더: atlcomtime.h

참고 항목

참조

COleDateTime 클래스

계층 구조 차트

COleDateTime::ParseDateTime

COleDateTime::GetStatus