共用方式為

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