COleDateTime::COleDateTime

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

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 オブジェクトを構築します。

詳細については、Windows SDK の「VARIANT」を参照してください。

time_t データ型の詳細については、「ランタイムライブラリリファレンス」の「time、_time64」関数を参照してください。

詳細については、Windows SDK の SYSTEMTIME 構造体と FILETIME 構造体を参照してください。

MS-DOS の日付値および時刻値の詳細については、Windows SDK の「DosDateTimeToVariantTime」を参照してください。

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);