COleDateTime::COleDateTime

2011-08-09

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 (1899 年 12 月 30 日午前 0 時) に初期設定された COleDateTime オブジェクトを構築します。
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 オブジェクトを構築します。
COleDateTime( systimeSrc ) 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.100).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);