CTime オブジェクトに格納されている時刻値を分割して保持する struct tm 構造体を取得します。
struct tm* GetGmtTm(
struct tm* ptm
) const;
パラメーター
- ptm
時刻データを受け取るバッファーへのポインター。 このポインターが NULL の場合、例外がスローされます。
戻り値
値が設定された struct tm 構造体へのポインターを返します。この構造体はインクルード ファイル TIME.H で定義されています。 構造体のレイアウトについては、「gmtime、_gmtime32、_gmtime64」を参照してください。
解説
GetGmtTm 関数は、協定世界時刻 (UTC) を返します。
ptm に NULL は指定できません。 従来の動作 (ptm を NULL とすることで、静的に割り当てられた内部バッファーを使用できる) に戻す場合は、_SECURE_ATL を未定義の状態にします。
使用例
// Compute difference between local time and GMT
CTime time(CTime::GetCurrentTime());
tm t1, t2;
time.GetLocalTm(&t1);
time.GetGmtTm(&t2);
ATLTRACE(_T("Difference between local time and GMT is %d hours.\n"),
t1.tm_hour - t2.tm_hour);
必要条件
**ヘッダー:**atltime.h