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