CTime::CTime

Artikel
02/26/2013

Erstellt ein neues Objekt CTime, die der angegebenen Zeit initialisiert wird.

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

Parameter

timeSrc
Gibt ein CTime-Objekt an, das bereits vorhanden ist.
time
Ein __time64_t Zeitwert, der die Anzahl der Sekunden nach dem 1. Januar 1970 UTC ist.Beachten Sie, dass dieses auf die Ortszeit angepasst wird.Wenn Sie beispielsweise in New York sind und ein CTime-Objekt erstellen, indem Sie einen Parameter aus 0 übergeben, gibt CTime::GetMonth 12 zurück.

In Visual C++-Versionen 6,0 und früher, war time ein Wert von time_t.Visual C++ .NET. und höhere Konvertiert ein time_t-Parameter zu __time64_t.
nYear, nMonth, nDay, nHour, nMin, nSec
Gibt die in das neue Objekt CTime kopiert werden Datums- und Uhrzeitwerte.
nDST
Gibt an, ob Sommerzeit gültig ist.Kann einen von drei Werten haben:
- nDST, das Normalzeit auf 0 festgelegt wird, ist wirksam.
- nDST, das einer größeren Wert als 0 Sommerzeit festgelegt wird, ist wirksam.
- nDST festgelegt auf einen Wert kleiner als 0 standardmäßig.Setzt automatisch, ob Normalzeit oder Sommerzeit gültig ist.
wDosDate, wDosTime
MS-DOS in einen Datums-/Uhrzeitwert konvertiert werden und Datums- und Uhrzeitwerte, in neue CTime das Objekt kopiert.
st
Eine in einen Datums-/Uhrzeitwert konvertiert werden und SYSTEMTIME-Struktur, in CTime das neue Objekt kopiert.
ft
Eine in einen Datums-/Uhrzeitwert konvertiert werden und FILETIME-Struktur, in CTime das neue Objekt kopiert.
dbts
Ein Verweis auf eine DBTimeStamp-Struktur, die die aktuelle lokale Zeit enthält.

Hinweise

Jeder Konstruktor wird nachfolgend beschrieben:

CTime( ); erstellt einen nicht initialisierten CTime-Objekt.Dieser Konstruktor ermöglicht es Ihnen, CTime-Objektarrays zu definieren.Vor Verwendung Sie sollten solche Arrays mit Gültigkeitszeiten initialisieren.
CTime( const CTime& ); erstellt ein CTime-Objekt von einem anderen CTime-Wert.
CTime( __time64_t );CTime erstellt ein Objekt aus einem __time64_t-Typ.Dieser Konstruktor erwartet die UTC-Zeit und konvertiert das Ergebnis auf eine Ortszeit, bevor das Ergebnis gespeichert wird.
Konstrukte CTime( int, int,...); ein CTime-Objekt von den Ortszeitkomponenten mit jeder Komponente beschränkt zu den folgenden Bereichen:

Komponente

Bereich

nYear

1970–3000

nMonth

1–12

nDay

1–31

nHour

0-23

nMin

0-59

nSec

0-59

Dieser Konstruktor nimmt die entsprechende Konvertierung in UTC.Die Debugversion der Microsoft Foundation Class-Bibliothek-Assertionen, wenn eine oder mehrere der Zeitkomponenten außerhalb des Bereichs befinden.Sie müssen die Argumente überprüfen, bevor Sie aufrufen.Dieser Konstruktor erwartet eine Ortszeit.
CTime( WORD, WORD ); erstellt ein CTime-Objekt aus den angegebenen MS-DOS Datums- und Uhrzeitwerte.Dieser Konstruktor erwartet eine Ortszeit.
CTime( const SYSTEMTIME& );CTime erstellt ein Objekt aus einer SYSTEMTIME-Struktur.Dieser Konstruktor erwartet eine Ortszeit.
CTime( const FILETIME& );CTime erstellt ein Objekt aus einer FILETIME-Struktur.Sie wahrscheinlich verwenden keine Initialisierung CTimeFILETIME direkt.Wenn Sie ein CFile-Objekt verwenden, um eine Datei zu bearbeiten, ruft CFile::GetStatus den Dateizeitstempel für Sie durch ein CTime-Objekt ab, das einer FILETIME-Struktur initialisiert wird.Dieser Konstruktor akzeptiert eine Uhrzeit basierend auf UTC an und konvertiert automatisch den Wert in Ortszeit, bevor das Ergebnis gespeichert wird.

Hinweis

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

Komponente	Bereich
nYear	1970–3000
nMonth	1–12
nDay	1–31
nHour	0-23
nMin	0-59
nSec	0-59

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

Weitere Informationen finden Sie in SYSTEMTIME und FILETIME-Struktur in Windows SDK.Siehe auch den MS-DOS Datum und Zeit Eintrag in Windows SDK.

Beispiel

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