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
1970 年 1 月 1 日 1 である __time64_t の日付値と時刻の秒数。これは、の現地時刻に合わせて調整されることに注意してください。たとえば、ニューヨークにあり、0 のパラメーターを渡して CTime のオブジェクトを作成する場合は、CTime::GetMonth は 12 を返します。Visual C++ バージョン 6.0 以前では、time は time_tの値です。Visual C++ .NET 以降の変換 __time64_tへの time_t のパラメーター。
nYear, nMonth, nDay, nHour, nMin, nSec
CTime の新しいオブジェクトにコピーされる日付と時刻の値を示します。nDST
夏時間の時間が有効かどうかを示します。3 の値から 1 を指定できます: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 ライブラリの assert のデバッグ バージョン。呼び出す前に、引数を検証する必要があります。このコンストラクターは、現地時刻を要求します。
CTime ( WORD, WORD ) ; は、指定した MS-DOS の日付と時刻の値から CTime オブジェクトを構築します。このコンストラクターは、現地時刻を要求します。
CTime ( const SYSTEMTIME& ) ; は SYSTEMTIME の構造体からの CTime オブジェクトを構築します。このコンストラクターは、現地時刻を要求します。
CTime ( const FILETIME& ) ; は FILETIME の構造体からの CTime オブジェクトを構築します。場合 CTimeFILETIME の初期化を直接使用しません。ファイルを処理するために CFile のオブジェクトを使用して CFile::GetStatus は FILETIME の構造で初期化される CTime のオブジェクトを通じて行います。のファイルのタイム スタンプを取得します。このコンストラクターは、時刻を UTC に基づいて想定し、現地時刻に結果を格納する前に値が自動的に変換します。
[!メモ]
DBTIMESTAMP パラメーターを使用するコンストラクターを利用できるのは、OLEDB.h がインクルードされているときだけです。
詳細については、Windows SDKの SYSTEMTIME と FILETIME の構造体を参照してください。また Windows SDKの MS-DOS の日付と時刻 のエントリを参照してください。
使用例
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
必要条件
ヘッダー : atltime.h