COleDateTime::COleDateTime
COleDateTime オブジェクトを構築します。
COleDateTime( ) throw( );
COleDateTime(
const VARIANT& varSrc
) throw( );
COleDateTime(
DATE dtSrc
) throw( );
COleDateTime(
time_t timeSrc
) throw( );
COleDateTime(
__time64_t timeSrc
) throw( );
COleDateTime(
const SYSTEMTIME& systimeSrc
) throw( );
COleDateTime(
const FILETIME& filetimeSrc
) throw( );
COleDateTime(
int nYear,
int nMonth,
int nDay,
int nHour,
int nMin,
int nSec
) throw( );
COleDateTime(
WORD wDosDate,
WORD wDosTime
) throw( );
COleDateTime(
const DBTIMESTAMP& dbts
) throw();
パラメーター
dateSrc
新しい COleDateTime オブジェクトにコピーされる既存の COleDateTime オブジェクト。varSrc
日付/時刻値 (VT_DATE) に変換され、新しい COleDateTime オブジェクトにコピーされる、既存の VARIANT データ構造体 (COleVariant オブジェクトの場合もあります)。dtSrc
新しい COleDateTime オブジェクトにコピーされる、日付/時刻値 (DATE)。timeSrc
日付/時刻値に変換され、新しい COleDateTime オブジェクトにコピーされる time_t 値または __time64_t 値。systimeSrc
日付/時刻値に変換され、新しい COleDateTime オブジェクトにコピーされる SYSTEMTIME 構造体。filetimeSrc
日付/時刻値に変換され、新しい COleDateTime オブジェクトにコピーされる FILETIME 構造体。FILETIME は世界協定時刻 (UTC) を使用するため、地域時間を渡すと不正な結果になります。詳細については、Windows SDK の「File Times」を参照してください。nYear, nMonth, nDay, nHour, nMin, nSec
新しい COleDateTime オブジェクトにコピーされる日付値と時刻値。wDosDate, wDosTime
日付/時刻値に変換され、新しい COleDateTime オブジェクトにコピーされる MS-DOS の日付値と時刻値。dbts
現在の現地時刻を保持する DBTimeStamp 構造体への参照。
解説
次のコンストラクターはすべて、指定された値で初期化された新しい COleDateTime オブジェクトを構築します。次の表は、日付および時刻コンポーネントの有効範囲の一覧です。
日付/時刻コンポーネント |
有効範囲 |
---|---|
年 |
100 – 9999 |
月 |
0 – 12 |
日 |
0 – 31 |
時間 (時) |
0 – 23 |
分 |
0 – 59 |
秒 |
0 – 59 |
日コンポーネントの実際の上限は、月および年コンポーネントによって変わります。詳細については、SetDate または SetDateTime メンバー関数を参照してください。
各コンストラクターについての簡単な説明は、次のとおりです。
COleDateTime() の構成要素を 0 に初期化される COleDateTime のオブジェクト (午前 1899 年 1 月 12 日 30)。
COleDateTime(dateSrc) は COleDateTime の既存のオブジェクトから COleDateTime オブジェクトを構築します。
COleDateTime(varSrcの) は COleDateTime オブジェクトを構築します。VARIANT 構造体、または COleVariant オブジェクトを日付/時刻 (VT_DATE) 値に変換します。変換に成功すると、変換された値が新しい COleDateTime オブジェクトにコピーされます。失敗すると、COleDateTime オブジェクトの値が 0 (1899 年 12 月 30 日午前 0 時) に設定され、状態は無効になります。
COleDateTime(dtSrc) は DATE の値から COleDateTime オブジェクトを構築します。
COleDateTime(timeSrc) は time_t の値から COleDateTime オブジェクトを構築します。
systimeSrcCOleDateTime(の) は SYSTEMTIME の値から COleDateTime オブジェクトを構築します。
COleDateTime(filetimeSrc) は FILETIME の値から COleDateTime オブジェクトを構築します。.FILETIME は世界協定時刻 (UTC) を使用するため、地域時間を渡すと不正な結果になります。詳細については、Windows SDK の「File Times」を参照してください。
COleDateTime(nYear、nMonth、nDay、nHour、nMin、nSec) は、指定された数値の COleDateTime オブジェクトを構築します。
COleDateTime(wDosDate、wDosTime) は、指定した MS-DOS の日付と時刻の値から COleDateTime オブジェクトを構築します。
time_t1f4c8f33(v=vs.110).md データ型の詳細については、「ランタイム ライブラリ リファレンス」の「time、_time64」関数を参照してください。
詳細については、Windows SDK の SYSTEMTIME 構造体と FILETIME 構造体を参照してください。
COleDateTime 値の範囲の詳細については、「日付と時刻 : オートメーションのサポート」を参照してください。
[!メモ]
DBTIMESTAMP パラメーターを使用するコンストラクターを利用できるのは、OLEDB.h がインクルードされているときだけです。
使用例
time_t osBinaryTime; // C run-time time (defined in <time.h>)
time(&osBinaryTime); // Get the current time from the
// operating system.
COleDateTime time1; // initialized to 00:00am, 30 December 1899
// (and m_nStatus is valid!)
COleDateTime time2 = time1; // Copy constructor
COleDateTime time3(osBinaryTime); // from time_t
COleDateTime time4(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
SYSTEMTIME sysTime; // Win32 time information
GetSystemTime(&sysTime);
COleDateTime time5(sysTime);
必要条件
ヘッダー : atlcomtime.h