共用方式為


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 秒在目前 Minute 中

    • %% 百分比符號

  • nFormatID
    字串格式控制項的資源 ID。

傳回值

包含格式化的日期/時間值的 CString

備註

如果這個物件 COleDateTime 狀況是空的,則傳回值是空字串。 如果狀態無效,傳回字串由字串資源 ATL_IDS_DATETIME_INVALID指定。

三種形式的概要說明這個函式的後面:

  • Format( dwFlags, lcid)
    這個表單格式化值使用語言規格 (地區設定 ID) 的日期和時間。 使用預設參數,這個表單將列印日期和時間,,除非時間部分為零 (午夜),在這種情況下,它會列印日期的情況下,或日期部分為零 (而 12 月將日),在這種情況下,它會列印時的情況。 如果日期/時間值為零 (而年 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"));   

需求

Header: atlcomtime.h

請參閱

參考

COleDateTime 類別

階層架構圖

COleDateTime::ParseDateTime

COleDateTime::GetStatus