COleDateTime::COleDateTime

Artikel
02/26/2013

Erstellt ein COleDateTime-Objekt.

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

Parameter

dateSrc
Ein vorhandenes in das neue COleDateTime-Objekt kopiert werden COleDateTime-Objekt.
varSrc
Eine vorhandene in einen Datums-/Uhrzeitwert (VT_DATE) konvertiert werden und VARIANT Datenstruktur (möglicherweise ein COleVariant-Objekt) in neue COleDateTime das Objekt kopiert.
dtSrc
Ein Datum/Uhrzeit (DATE)-Wert, der in das neue COleDateTime-Objekt kopiert werden soll.
timeSrc
Ein in einen Datums-/Uhrzeitwert konvertiert werden und time_t oder __time64_t-Wert, in COleDateTime das neue Objekt kopiert.
systimeSrc
Eine in einen Datums-/Uhrzeitwert konvertiert werden und SYSTEMTIME-Struktur, in COleDateTime das neue Objekt kopiert.
filetimeSrc
Eine in einen Datums-/Uhrzeitwert konvertiert werden und FILETIME-Struktur, in COleDateTime das neue Objekt kopiert.Beachten Sie, dass FILETIME koordinierte Weltzeit (UTC) verwendet, damit, wenn Sie eine Ortszeit in der Struktur übergeben, sind die Ergebnisse falsch.Siehe Datei-Zeiten in Windows SDK weitere Informationen.
nYear, nMonth, nDay, nHour, nMin, nSec
Geben Sie die Datums- und Uhrzeitwerte an, die in das neue COleDateTime-Objekt kopiert werden sollen.
wDosDate, wDosTime
MS-DOS in einen Datums-/Uhrzeitwert konvertiert werden und Datums- und Uhrzeitwerte, in neue COleDateTime das Objekt kopiert.
dbts
Ein Verweis auf eine DBTimeStamp-Struktur, die die aktuelle lokale Zeit enthält.

Hinweise

Alle diese Konstruktoren erstellen neue COleDateTime-Objekte, die dem angegebenen Wert initialisiert werden.Die folgende Tabelle zeigt gültige Bereiche für jedes Datum und Zeitkomponente an:

Datum/Uhrzeit-Komponente	Gültiger Bereich
Jahr	100 – 9999
Monat	0 – 12
Tag	0 – 31
Stunde	0 – 23
Minute	0 – 59
second	0 – 59

Beachten Sie, dass die tatsächliche Obergrenze für die Tageskomponente auf Grundlage der Monats- und Jahrkomponenten variiert.Weitere Informationen finden Sie in der SetDate oder SetDateTime-Memberfunktionen.

Im Folgenden finden Sie eine kurze Beschreibung jedes Konstruktors:

Konstrukte COleDateTime() ein COleDateTime-Objekt initialisiert auf 0 (Mitternacht, am 30. Dezember 1899).
COleDateTime(dateSrc) erstellt ein Objekt COleDateTime aus einem vorhandenen COleDateTime-Objekt.
COleDateTime(varSrc) erstellt ein COleDateTime-Objekt.Versucht, eine VARIANT-Struktur oder ein COleVariant-Objekt auf einen Wert der Datum/Uhrzeit (VT_DATE) konvertiert.Wenn diese Konvertierung erfolgreich ist, wird der konvertierte Wert in das neue COleDateTime-Objekt kopiert.Wenn dies nicht der Fall ist, wird der Wert des Objekts COleDateTime auf 0 (Mitternacht, am 30. Dezember 1899) und den Status zu ungültigem festgelegt.
COleDateTime(dtSrc)COleDateTime erstellt ein Objekt aus einem DATE-Wert.
COleDateTime(timeSrc)COleDateTime erstellt ein Objekt aus einem time_t-Wert.
COleDateTime(systimeSrc)COleDateTime erstellt ein Objekt aus einem SYSTEMTIME-Wert.
COleDateTime(filetimeSrc)COleDateTime erstellt ein Objekt aus einem FILETIME-Wert..Beachten Sie, dass FILETIME koordinierte Weltzeit (UTC) verwendet, damit, wenn Sie eine Ortszeit in der Struktur übergeben, sind die Ergebnisse falsch.Siehe Datei-Zeiten in Windows SDK weitere Informationen.
COleDateTime(nYear, nMonth, nDay, nHour, nMin, nSec) erstellt ein COleDateTime-Objekt aus den angegebenen numerischen Werten.
COleDateTime(wDosDate, wDosTime) erstellt ein COleDateTime-Objekt aus den angegebenen MS-DOS Datums- und Uhrzeitwerte.

Weitere Informationen zu den time_t Datentyp, die Zeit-Funktion finden Sie unter in der Laufzeitbibliotheksreferenz.

Weitere Informationen finden Sie in SYSTEMTIME und FILETIME-Strukturen in Windows SDK.

Weitere Informationen über die Grenzen für COleDateTime-Werte, finden Sie im Artikel Datum und Uhrzeit: Automatisierungs-Unterstützung.

Hinweis
Der Konstruktor mit DBTIMESTAMP-Parameters ist nur verfügbar, wenn OLEDB.h enthalten ist.

Beispiel

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