CTime-Klasse

Artikel
02/26/2013

Stellt eine absoluten Zeit und ein Datum dar.

class CTime

Mitglieder

Öffentliche Konstruktoren

Name	Description
CTime::CTime	Erstellt CTime-Objekte auf verschiedene Arten.

Öffentliche Methoden

Name	Description
CTime::Format	Konvertiert ein Objekt in CTime ein formatiertes zeichenfolgenbasiertes auf der lokalen Zeitzone.
CTime::FormatGmt	Konvertiert ein Objekt in CTime ein formatiertes zeichenfolgenbasiertes auf UTC.
CTime::GetAsDBTIMESTAMP	Konvertiert die Zeitinformationen, die im CTime-Objekt einer Win32-compatible DBTimeStamp-Struktur gespeichert werden.
CTime::GetAsSystemTime	Konvertiert die Zeitinformationen, die im CTime-Objekt einer Win32-compatible SYSTEMTIME-Struktur gespeichert werden.
CTime::GetCurrentTime	Erstellt ein CTime-Objekt, das die aktuelle Uhrzeit (statische Memberfunktion) darstellt.
CTime::GetDay	Gibt den Tag darstellen CTime durch das Objekt zurück.
CTime::GetDayOfWeek	Gibt den Wochentag zurück, der durch das CTime-Objekt dargestellt wird.
CTime::GetGmtTm	Stellt ein CTime-Objekt in Komponenten auf Grundlage UTC auf.
CTime::GetHour	Gibt die Stunde zurück, die vom CTime-Objekt dargestellt wird.
CTime::GetLocalTm	Stellt ein CTime-Objekt in Komponenten basierend auf die lokale Zeitzone auf.
CTime::GetMinute	Gibt die Minute zurück, die vom CTime-Objekt dargestellt wird.
CTime::GetMonth	Gibt den Monat zurück, der durch das CTime-Objekt dargestellt wird.
CTime::GetSecond	Gibt das zweite dargestellt durch das CTime-Objekt zurück.
CTime::GetTime	Gibt einen __time64_t-Wert für das angegebene Objekt CTime zurück.
CTime::GetYear	Gibt das Jahr zurück, das durch das CTime-Objekt dargestellt wird.
CTime::Serialize64	Serialisiert Daten in oder aus einem Archiv.

Operatoren

Operator + -	Diese Operatoren hinzufügen und entfernen CTimeSpan und CTime-Objekte.
Operator +=, - =	Diese Operatoren hinzufügen und entfernen CTimeSpan ein Objekt nach und von diesem CTime-Objekt.
Operator =	Der Zuweisungsoperator.
Operator ==, <, usw..	Vergleichsoperatoren.

Hinweise

CTime hat keine Basisklasse.

CTime-Werte basieren auf koordinierte Weltzeit (UTC), die zur koordinierten Weltzeit (Greenwich Mean Time, GMT) entspricht.Siehe Zeit-Verwaltung zu Informationen darüber, wie die Zeitzone bestimmt wird.

Wenn Sie ein CTime-Objekt erstellen, legen Sie den nDST-Parameter auf 0 fest, um anzugeben, dass Normalzeit gültig ist, oder einen Wert, der größer ist als 0, anzugeben, dass Sommerzeit gültig ist, oder auf einen Wert kleiner als null für das die C-Laufzeitbibliotheks-Codeberechnung, ob Normalzeit oder Sommerzeit gültig ist.tm_isdst ist ein Pflichtfeld.Wenn nicht festgelegt ist, wird der Wert undefiniert und der Rückgabewert von mktime ist unvorhersehbar.Wenn timeptr zu einer TM-Struktur zeigt, die durch einen früheren Aufruf asctime_s, zu _gmtime_s oder zu localtime_s zurückgegeben wird, enthält das tm_isdst Feld den richtigen Wert.

Eine Assistentenklasse, CTimeSpan, bietet ein Zeitintervall dar.

Die CTime und CTimeSpan-Klassen sind nicht für Ableitung vorgesehen.Da keine virtuellen Funktionen gibt, ist die Größe von CTime und von CTimeSpan-Objekten genau 8 Bytes.Die meisten Memberfunktionen sind inline.

Hinweis
Die obere Datumsgrenze 31.12.3000 ist.Die Untergrenze ist 1/1/1970 12:00: GMT 00 fest.

Weitere Informationen zur Verwendung von CTime, finden Sie in Artikel Datum und Uhrzeit und Zeit-Verwaltung in der Laufzeitbibliotheksreferenz.

Hinweis
Die CTime-Struktur geändert von MFC 7.1 zu MFC 8.0.Wenn Sie eine CTime-Struktur serialisieren, indem Sie operator << unter MFC 8.0 oder einer höheren Version verwenden, ist die resultierende Datei nicht auf früheren Versionen von MFC lesbar.