CTime::GetLocalTm

  • [アーティクル]

更新 : 2007 年 11 月

CTime オブジェクトに格納されている時刻値を分割して保持する struct tm 構造体を取得します。

struct tm* GetLocalTm(
   struct tm* ptm 
) const;

パラメータ

  • ptm
    時刻データを受け取るバッファへのポインタ。このポインタが NULL の場合、例外がスローされます。

戻り値

値が設定された struct tm 構造体へのポインタを返します。この構造体はインクルード ファイル TIME.H で定義されています。構造体のレイアウトについては、「gmtime、_gmtime32、_gmtime64」を参照してください。

解説

GetLocalTm 関数は、地域時間を返します。

ptm として NULL を使用することはできません。従来の動作 (ptm を NULL とすることで、静的に割り当てられた内部バッファを使用できる) に戻す場合は、_SECURE_ATL を未定義の状態にします。

使用例

CTime t(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
tm osTime;  // A structure containing time elements.
t.GetLocalTm(&osTime);
ATLASSERT(osTime.tm_mon == 2); // Note zero-based month!

必要条件

ヘッダー : atltime.h

参照

参照

CTime クラス

階層図

その他の技術情報

CTime のメンバ