次の方法で共有


CTime クラス

絶対時刻と絶対日付を表します。

class CTime

メンバー

78zb0ese.collapse_all(ja-jp,VS.110).gifパブリック コンストラクター

名前

説明

CTime::CTime

さまざまな方法で CTime オブジェクトを構築します。

78zb0ese.collapse_all(ja-jp,VS.110).gifパブリック メソッド

名前

説明

CTime::Format

地域のタイム ゾーンに基づいて、CTime オブジェクトを書式化された文字列に変換します。

CTime::FormatGmt

UTC に基づいて、CTime オブジェクトを書式化された文字列に変換します。

CTime::GetAsDBTIMESTAMP

CTime オブジェクトに格納された時間情報を Win32 互換の DBTimeStamp 構造体に変換します。

CTime::GetAsSystemTime

CTime オブジェクトに格納された時間情報を Win32 互換の SYSTEMTIME 構造体に変換します。

CTime::GetCurrentTime

現在時刻を表す CTime オブジェクトを構築します (静的メンバー関数)。

CTime::GetDay

CTime オブジェクトによって表される日を返します。

CTime::GetDayOfWeek

CTime オブジェクトによって表される曜日を返します。

CTime::GetGmtTm

UTC に基づいて、CTime オブジェクトを構成要素に分類します。

CTime::GetHour

CTime オブジェクトによって表される時を返します。

CTime::GetLocalTm

地域のタイム ゾーンに基づいて、CTime オブジェクトを構成要素に分類します。

CTime::GetMinute

CTime オブジェクトによって表される分を返します。

CTime::GetMonth

CTime オブジェクトによって表される月を返します。

CTime::GetSecond

CTime オブジェクトによって表される秒を返します。

CTime::GetTime

指定された CTime オブジェクトに対する time64_t の値を返します。

CTime::GetYear

CTime オブジェクトによって表される年を返します。

CTime::Serialize64

アーカイブにデータをシリアル化したり、アーカイブからデータをシリアル化したりします。

78zb0ese.collapse_all(ja-jp,VS.110).gif演算子

operator + –

CTimeSpan オブジェクトおよび CTime オブジェクトを加算および減算します。

operator +=、–=

CTimeSpan オブジェクトと CTime オブジェクトを加算します。また、CTime オブジェクトから CTimeSpan オブジェクトを減算します。

operator =

代入演算子です。

演算子 ==、など <.

比較演算子です。

解説

CTime には、基本クラスはありません。

CTime の値は、協定世界時刻 (UTC: Coordinated Universal Time) を基準にしています。協定世界時はグリニッジ標準時刻 (GMT: Greenwich Mean Time) と同じです。タイム ゾーンの指定方法については、「時間管理」を参照してください。

CTime オブジェクトを作成するとき、nDST パラメーターには、標準時間を使用する場合は 0、夏時間を適用する場合は 0 より大きい値、C ランタイム ライブラリのコードによって標準時か夏時間かを自動判定する場合は 0 より小さい値を設定します。tm_isdst は必須のフィールドです。設定しないと、その値は定義されず、mktime からは予想外の値が返されます。timeptr が前の asctime_s_gmtime_s、または localtime_s の呼び出しで返された tm 構造体を指す場合は、tm_isdst フィールドに正しい値が設定されています。

類似クラスである CTimeSpan は、時間間隔を表します。

CTime クラスと CTimeSpan クラスは、派生クラスを生成するようにはデザインされていません。仮想関数がないため、CTime オブジェクトおよび CTimeSpan オブジェクトのサイズは厳密に 8 バイトになります。ほとんどのメンバー関数はインライン関数になります。

[!メモ]

対応できる日付の上限は 3000/12/31 です。下限は 1970/1/1 12:00:00 AM GMT です。

CTime の使い方の詳細については、「ランタイム ライブラリ リファレンス」の「日付と時刻」および「時間管理」を参照してください。

[!メモ]

CTime 構造体は、MFC 7.1 から MFC 8.0 に変更されました。MFC 8.0 またはそれ以降のバージョンで operator << を使用して CTime 構造体をシリアル化すると、それより前のバージョンの MFC では生成ファイルを読み取ることができなくなります。

必要条件

ヘッダー : atltime.h

参照

関連項目

asctime_s、_wasctime_s

_ftime_s、_ftime32_s、_ftime64_s

gmtime_s、_gmtime32_s、_gmtime64_s

localtime_s、_localtime32_s、_localtime64_s

strftime、wcsftime、_strftime_l、_wcsftime_l

time、_time32、_time64

CTimeSpan クラス

階層図

その他の技術情報

ATL/MFC の共有クラス