CTime::CTime

發行項
02/28/2013

建立新的 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
__time64_t 時間值，是秒數) 1970 年 1 月 1 日之後的 UTC。請注意這對本地時間會進行調整。例如，在中，如果您在紐約並傳遞參數建立物件 CTime 0， 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
表示日光節約時間是否在作用中。可以有三個值的其中一項:
- nDST 設為 0 標準時間就會生效。
- nDST 設為值大於 0 日光節約時間為作用中。
- nDST 設為小於 0 的值。預設值為。自動計算標準時間或日光節約時間是否在作用中。
wDosDate, wDosTime
MS-DOS 日期和時間值會轉換為日期/時間值和複製到新的 CTime 物件。
st
SYSTEMTIME 結構都會轉換成日期/時間值和複製到新的 CTime 物件。
ft
FILETIME 結構都會轉換成日期/時間值和複製到新的 CTime 物件。
dbts
out 包含目前本地時間的 DBTimeStamp 結構的參考。

備註

每個建構函式的說明如下:

CTime( ); 建構未初始化的 CTime 物件。這個建構函式可讓您定義 CTime 物件陣列。您應該使用到期日的這類陣列才能使用。
CTime( const CTime_& ); 從另一個 CTime 值的 CTime 物件。
CTime( __time64_t ); 從 __time64_t 型別的 CTime 物件。這個建構函式必須有 UTC 時間和轉換運算結果為本地時間在儲存結果之前。
CTime( int, int,…); 從本地時間元件的 CTime 物件有限制的每個元件的參考下列範圍:

元件

Range

nYear

1970–3000

nMonth

1–12

nDay

1–31

nHour

0-23

nMin

0-59

nSec

0-59

這個建構函式會對 UTC 的適當轉換。 MFC 程式庫的偵錯版本判斷提示一或多個時間元件是否超出範圍。您必須在呼叫之前先驗證引數。這個建構函式所預期的本地時間。
CTime( WORD, WORD ); 從指定的 MS-DOS 日期和時間值的 CTime 物件。這個建構函式所預期的本地時間。
CTime( const SYSTEMTIME_& ); 從 SYSTEMTIME 結構的 CTime 物件。這個建構函式所預期的本地時間。
CTime( const FILETIME_& ); 從 FILETIME 結構的 CTime 物件。您不會直接最可能使用 CTimeFILETIME 初始化。如果您正在使用 CFile 物件管理檔案， CFile::GetStatus 傳遞 CTime 物件擷取您的檔案時間戳記初始化 FILETIME 結構。這個建構函式會假設根據 UTC 時間和自動將值轉換成當地時間在儲存結果之前。

注意事項

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

元件	Range
nYear	1970–3000
nMonth	1–12
nDay	1–31
nHour	0-23
nMin	0-59
nSec	0-59

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

如需詳細資訊，請參閱 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