COleDateTime::COleDateTime

發行項
02/28/2013

建構 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
現有的 VARIANT 資料結構 (可能 COleVariant 物件) 會轉換為日期時間值 (VT_DATE) 和複製到新的 COleDateTime 物件。
dtSrc
要複製的日期/時間 ()DATE值至新的 COleDateTime 物件。
timeSrc
time_t 或 __time64_t 值會轉換為日期/時間值和複製到新的 COleDateTime 物件。
systimeSrc
SYSTEMTIME 結構都會轉換成日期/時間值和複製到新的 COleDateTime 物件。
filetimeSrc
FILETIME 結構都會轉換成日期/時間值和複製到新的 COleDateTime 物件。請注意 FILETIME 使用全球定位時間 (UTC)，，因此，如果您從結構的本地時間，則結果會是無效的。請參閱在 Windows SDK 的檔案時間以取得詳細資訊。
nYear, nMonth, nDay, nHour, nMin, nSec
表示要複製的日期和時間值輸入新的 COleDateTime 物件。
wDosDate, wDosTime
MS-DOS 日期和時間值會轉換為日期/時間值和複製到新的 COleDateTime 物件。
dbts
out 包含目前本地時間的 DBTimeStamp 結構的參考。

備註

這些建構函式會建立新的 COleDateTime 物件初始化為指定的值。下表顯示日期和時間元件的有效範圍:

日期/時間元件	有效範圍
年份	100 – 9999
月份	0 – 12
日期	0 – 31
小時	0 – 23
分鐘	0 – 59
接著	0 – 59

請注意日期元件的實際上限隨著月份和年份元件。如需詳細資訊，請參閱 SetDate 或 SetDateTime 成員函式。

下列每個建構函式的簡要說明:

COleDateTime() 建構 COleDateTime 物件初始化為 0 (午夜， 1899 年 12 月 30 日)。
COleDateTime(dateSrc) 從現有的 COleDateTime 物件的 COleDateTime 物件。
COleDateTime(varSrc)COleDateTime 建構物件。嘗試將轉換為 VARIANT 結構或 COleVariant 物件為日期/時間 (VT_DATE) 值。如果轉換成功，但轉換後的值複製到新的 COleDateTime 物件。如果不是， COleDateTime 物件的值設定為午夜 (0， 1899 年 12 月 30 日) 和其為無效的狀態。
COleDateTime(dtSrc) 從 DATE 值的 COleDateTime 物件。
COleDateTime(timeSrc) 從 time_t 值的 COleDateTime 物件。
COleDateTime(systimeSrc) 從 SYSTEMTIME 值的 COleDateTime 物件。
COleDateTime(filetimeSrc) 從 FILETIME 值的 COleDateTime 物件。.請注意 FILETIME 使用全球定位時間 (UTC)，，因此，如果您從結構的本地時間，則結果會是無效的。請參閱在 Windows SDK 的檔案時間以取得詳細資訊。
COleDateTime(nYear， nMonth， nDay， nHour， nMin， nSec) 從指定的數值的 COleDateTime 物件。
COleDateTime(wDosDate， wDosTime) 從指定的 MS-DOS 日期和時間值的 COleDateTime 物件。

如需 time_t 資料型別的詳細資訊，請參閱《 執行階段程式庫參考的時間函式。

如需詳細資訊，請參閱 Windows SDK的 SYSTEMTIME 和 FILETIME 結構。

如需 COleDateTime 值的繫結的詳細資訊，請參閱本文日期和時間:Automation 支援。

注意事項
當 OLEDB.h 所包含的時，請使用 DBTIMESTAMP 參數的建構函式都是可用的。

範例

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