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