CTime::CTime (ATL/MFC)

ビューの切り替え

CTime::CTime

すべて縮小

言語フィルタ

このページは次のバージョンについて記述しています。

Microsoft Visual Studio 2005/.NET Framework 2.0

その他のバージョンについては、以下の情報を参照してください。

Visual C++: 共有クラスリファレンス

CTime::CTime

指定された時刻で初期化された新しい CTime オブジェクトを作成します。

CTime( ) throw( );
CTime(
   __time64_t time 
) throw( );
CTime(
   int nYear,
   int nMonth,
   int nDay,
   int nHour,
   int nMin,
   int nSec,
      int nDST = -1 
);
CTime(
   WORD wDosDate,
   WORD wDosTime,
   int nDST = -1 
);
CTime(
   const SYSTEMTIME& st,
   int nDST = - 1 
) throw( );
CTime(
   const FILETIME& ft,
   int nDST = - 1 
);
CTime(
   const DBTIMESTAMP& dbts,
   int nDST = -1
) throw( );

パラメータ

timeSrc: 既存の CTime オブジェクト。

time

時刻を表す __time64_t 型の値。この値は、UTC を基準にした 1970 年 1 月 1 日から経過した秒数です。この値は、現地のタイムゾーンに合わせて調整する必要があります。たとえば、パラメータ 0 を渡して CTime オブジェクトを作成すると、ニューヨークでは、CTime::GetMonth は 12 を返します。

Visual C++ 6.0 およびそれ以前のバージョンでは、time は time_t の値でした。Visual C++ .NET 以降では、time_t 型のパラメータが __time64_t 型に変換されます。

nYear, nMonth, nDay, nHour, nMin, nSec: 新しい CTime オブジェクトにコピーする日時の値。

nDST

夏時間かどうかを示します。次のいずれかの値になります。

nDST が 0 のとき標準時間が有効です。
nDST が 0 より大きいとき夏時間が有効です。
nDST が 0 未満のとき既定値。自動的に標準時間か夏時間かが決定されます。

wDosDate, wDosTime: 日付/時刻値に変換され、新しい CTime オブジェクトにコピーされる MS-DOS の日付値と時刻値。

st: 日付/時刻型の値に変換され、新しい CTime オブジェクトにコピーされる SYSTEMTIME 構造体。

ft: 日付/時刻型の値に変換され、新しい CTime オブジェクトにコピーされる FILETIME 構造体。

dbts: 現在の現地時刻を保持する DBTIMESTAMP 構造体への参照。

解説

各コンストラクタについて説明します。

CTime( ); CTime オブジェクトを初期化せずに構築します。このコンストラクタを使用して、CTime オブジェクトの配列を定義できます。定義する配列は、使用する前に有効な値で初期化する必要があります。
CTime( const CTime& ); ほかの CTime 値から CTime オブジェクトを構築します。
CTime( time64_t ); __time64_t 型の値から CTime オブジェクトを構築します。このコンストラクタは UTC 時間を想定し、構築した結果を現地時間に変換してから格納します。
CTime( int, int, ...); 現地時間の各構成要素を指定して CTime オブジェクトを構築します。各構成要素は次のように制限されます。

構成要素範囲

nYear

1970–3000

nMonth

1–12

nDay

1–31

nHour

0-23

nMin

0-59

nSec

0-59

このコンストラクタは、値を UTC を基準にした値に正しく変換します。Microsoft Foundation Class ライブラリのデバッグ環境では、時間の構成要素の 1 つでも範囲外の場合は、アサートします。引数を確認してから、呼び出す必要があります。このコンストラクタは、現地時間を想定しています。
CTime( WORD, WORD ); 指定された MS-DOS の日付と時刻の値から CTime オブジェクトを構築します。このコンストラクタは、現地時間を想定しています。
CTime( const SYSTEMTIME& ); SYSTEMTIME 構造体から CTime オブジェクトを構築します。このコンストラクタは、現地時間を想定しています。
CTime( const FILETIME& ); FILETIME 構造体から CTime オブジェクトを構築します。CTime を FILETIME 構造体で直接初期化することはほとんどありません。CFile オブジェクトを使ってファイルを扱う場合は、FILETIME 構造体で初期化された CTime オブジェクトを使って、CFile::GetStatus を呼び出してファイルのタイムスタンプを取得します。このコンストラクタは UTC に基づく時間を想定し、値を現地時間に自動的に変換してから、構築結果を格納します。

メモ :

DBTIMESTAMP パラメータを使用するコンストラクタを利用できるのは、OLEDB.h がインクルードされているときだけです。

構成要素	範囲
nYear	1970–3000
nMonth	1–12
nDay	1–31
nHour	0-23
nMin	0-59
nSec	0-59

メモ :
DBTIMESTAMP パラメータを使用するコンストラクタを利用できるのは、OLEDB.h がインクルードされているときだけです。

詳細については、『Platform SDK』の SYSTEMTIME 構造体および FILETIME 構造体の説明を参照してください。また、『Platform SDK』の「MS-DOS Date and Time」も参照してください。

使用例

// Example for CTime::CTime
time_t osBinaryTime;  // C run-time time (defined in <time.h>)
time( &osBinaryTime ) ;  // Get the current time from the 
                         // operating system.
CTime time1; // Empty CTime. (0 is illegal time value.)
CTime time2 = time1; // Copy constructor.
CTime time3( osBinaryTime );  // CTime from C run-time time
CTime time4( 1999, 3, 19, 22, 15, 0 ); // 10:15PM March 19, 1999

参照

その他の技術情報

CTime のメンバ

タグ

: タグの追加

コミュニティコンテンツ

新しいコンテンツの追加

注釈

プロファイル (個人情報) の管理 | お問い合わせ先 | MSDN Flash ニュースレター | 日本での個人情報の取り扱い | サイトマップ

パラメータ

関連項目

その他の技術情報