次の方法で共有

CTimeSpan::Format

  • [アーティクル]

更新 : 2007 年 11 月

CTimeSpan の値に対応する、書式化された文字列を生成します。

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

パラメータ

  • pFormat, pszFormat
    printf の書式指定文字列と同じような書式指定文字列。パーセント (%) 記号に続く書式指定コードが、対応する CTimeSpan の構成要素によって置き換えられます。書式指定文字列のその他の文字は、変更されることなく戻り値の文字列にコピーされます。Format の書式指定コードの値とその意味の一覧を以下に示します。

    • %D   CTimeSpan の総日数

    • %H   現在 CTimeSpan が保持している値を、日、時、分、秒に変換したときの "時"

    • %M   現在 CTimeSpan が保持している値を、日、時、分、秒に変換したときの "分"

    • %S   現在 CTimeSpan が保持している値を、日、時、分、秒に変換したときの "秒"

    • %%   パーセント記号

  • nID
    この書式を識別する文字列の ID。

戻り値

書式化された時間を持つ CString オブジェクトを返します。

解説

ライブラリのデバッグ環境では、書式制御コードを調べ、上表にないコードが指定されたときはアサートします。

使用例

CTimeSpan ts(3, 1, 5, 12); // 3 days, 1 hour, 5 min, and 12 sec
CString s = ts.Format(_T("Total days: %D, hours: %H, mins: %M, secs: %S"));
ATLASSERT(s == _T("Total days: 3, hours: 01, mins: 05, secs: 12"));

必要条件

ヘッダー : atltime.h

参照

参照

CTimeSpan クラス

階層図

その他の技術情報

CTimeSpan のメンバ