CTime-Klasse

Artikel
10/12/2023

Stellt eine absolute Uhrzeit und ein absolutes Datum dar.

Syntax

class CTime

Member

Öffentliche Konstruktoren

Name	Beschreibung
CTime::CTime	`CTime` Erstellt Objekte auf verschiedene Arten.

Öffentliche Methoden

Name	Beschreibung
CTime::Format	Konvertiert ein `CTime` Objekt in eine formatierte Zeichenfolge , basierend auf der lokalen Zeitzone.
CTime::FormatGmt	Konvertiert ein `CTime` Objekt in eine formatierte Zeichenfolge , basierend auf UTC.
CTime::GetAsDBTIMESTAMP	Wandelt die im Objekt gespeicherten Zeitinformationen in `CTime` eine win32-kompatible DBTIMESTAMP-Struktur um.
CTime::GetAsSystemTime	Wandelt die im Objekt gespeicherten Zeitinformationen in `CTime` eine win32-kompatible SYSTEMTIME-Struktur um.
CTime::GetCurrentTime	Erstellt ein `CTime` Objekt, das die aktuelle Zeit darstellt (statische Memberfunktion).
CTime::GetDay	Gibt den Tag zurück, der `CTime` vom Objekt dargestellt wird.
CTime::GetDayOfWeek	Gibt den Wochentag zurück, der durch das `CTime` Objekt dargestellt wird.
CTime::GetGmtTm	Unterteilt ein `CTime` Objekt in Komponenten – basierend auf UTC.
CTime::GetHour	Gibt die Stunde zurück, die durch das `CTime` Objekt dargestellt wird.
CTime::GetLocalTm	Unterteilt ein `CTime` Objekt in Komponenten , basierend auf der lokalen Zeitzone.
CTime::GetMinute	Gibt die Minute zurück, die durch das `CTime` Objekt dargestellt wird.
CTime::GetMonth	Gibt den Monat zurück, der durch das `CTime` Objekt dargestellt wird.
CTime::GetSecond	Gibt die zweite vom `CTime` Objekt dargestellte Zurück.
CTime::GetTime	Gibt einen __time64_t Wert für das angegebene `CTime` Objekt zurück.
CTime::GetYear	Gibt das durch das `CTime` Objekt dargestellte Jahr zurück.
CTime::Serialize64	Serialisiert Daten in oder aus einem Archiv.

Operatoren

Name	Beschreibung
operator + -	Diese Operatoren addieren und subtrahieren `CTimeSpan` und `CTime` objekte.
operator +=, -=	Diese Operatoren addieren und subtrahieren ein `CTimeSpan` Objekt zu und von diesem `CTime` Objekt.
operator =	Der -Zuweisungsoperator.
Operator ==, < usw.	Vergleichsoperatoren.

Hinweise

CTime besitzt keine Basisklasse.

CTime Werte basieren auf koordinierter Weltzeit (UTC), die der koordinierten Weltzeit (Greenwich Mean Time, GMT) entspricht. Informationen dazu, wie die Zeitzone bestimmt wird, finden Sie unter "Zeitverwaltung ".

Wenn Sie ein CTime Objekt erstellen, legen Sie den nDST Parameter auf 0 fest, um anzugeben, dass die Standardzeit wirksam ist, oder auf einen Wert größer als 0, um anzugeben, dass die Sommerzeit wirksam ist, oder auf einen Wert kleiner als 0, damit der C-Laufzeitbibliothekscode berechnet, ob Standardzeit oder Sommerzeit wirksam ist. tm_isdst ist ein Pflichtfeld. Wenn nicht festgelegt, ist der Wert nicht definiert, und der Rückgabewert von mktime ist unvorhersehbar. Wenn timeptr auf eine tm-Struktur verweist, die von einem vorherigen Aufruf von asctime_s, _gmtime_s oder localtime_s zurückgegeben wird, enthält das tm_isdst Feld den richtigen Wert.

Eine Begleitklasse, CTimeSpan, stellt ein Zeitintervall dar.

Die CTime Klassen sind CTimeSpan nicht für die Ableitung konzipiert. Da keine virtuellen Funktionen vorhanden sind, beträgt die Größe CTime und CTimeSpan die Objekte genau 8 Byte. Die meisten Memberfunktionen sind inline.

Hinweis

Das Obere Datumslimit beträgt 12.31.3000. Die untere Grenze ist 1/1/1970 12:00:00 UHR GMT.

Weitere Informationen zur Verwendung CTimefinden Sie in den Artikeln "Datum und Uhrzeit" und "Zeitverwaltung " in der Laufzeitbibliotheksreferenz.

Hinweis

Die CTime Struktur wurde von MFC 7.1 zu MFC 8.0 geändert. Wenn Sie eine CTime Struktur mithilfe des Operators << unter MFC 8.0 oder einer höheren Version serialisieren, ist die resultierende Datei in älteren Versionen von MFC nicht lesbar.

Anforderungen

Kopfzeile: atltime.h

CTime-Vergleichsoperatoren

Vergleichsoperatoren.

bool operator==(CTime time) const throw();
bool operator!=(CTime time) const throw();
bool operator<(CTime time) const throw();
bool operator>(CTime time) const throw();
bool operator<=(CTime time) const throw();
bool operator>=(CTime time) const throw();

Parameter

time
Das zu vergleichende CTime-Objekt.

Rückgabewert

Diese Operatoren vergleichen zwei absolute Male und geben WAHR zurück, wenn die Bedingung wahr ist; andernfalls FALSE.

Beispiel

CTime t1 = CTime::GetCurrentTime();
CTime t2 = t1 + CTimeSpan(0, 1, 0, 0);    // 1 hour later
ATLASSERT(t1 != t2);
ATLASSERT(t1 < t2);
ATLASSERT(t1 <= t2);

CTime::CTime

Erstellt ein neues CTime Objekt, das mit der angegebenen Uhrzeit initialisiert wurde.

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 dies an Ihre Ortszeit angepasst wird. Wenn Sie sich beispielsweise in New York befinden und ein CTime Objekt erstellen, indem Sie einen Parameter von 0 übergeben, gibt CTime::GetMonth 12 zurück.

nYear, nMonth, nDay, nHour, nMin, nSec
Gibt die Datums- und Uhrzeitwerte an, die in das neue CTime Objekt kopiert werden sollen.

nDST
Gibt an, ob Sommerzeit wirksam ist. Kann einen von drei Werten haben:

nDST wird auf 0Standardzeit festgelegt.
nDST wird auf einen Wert festgelegt, der größer als 0Daylight-Zeit ist.
nDST auf einen Wert festgelegt, der kleiner als 0Die Standardeinstellung ist. Berechnet automatisch, ob Standardzeit oder Sommerzeit in Kraft ist.

wDosDate, wDosTime
MS-DOS-Datums- und Uhrzeitwerte, die in einen Datums-/Uhrzeitwert konvertiert und in das neue CTime Objekt kopiert werden sollen.

st
Eine SYSTEMTIME-Struktur , die in einen Datums-/Uhrzeitwert konvertiert und in das neue CTime Objekt kopiert werden soll.

Ft
Eine FILETIME-Struktur , die in einen Datums-/Uhrzeitwert konvertiert und in das neue CTime Objekt kopiert werden soll.

dbts
Ein Verweis auf eine DBTIMESTAMP-Struktur, die die aktuelle Ortszeit enthält.

Hinweise

Jeder Konstruktor wird unten beschrieben:

CTime(); Erstellt ein nicht initialisiertes CTime Objekt. Mit diesem Konstruktor können Sie Objektarrays definieren CTime . Sie sollten solche Arrays vor der Verwendung mit gültigen Zeiten initialisieren.
CTime( const CTime& ); Erstellt ein Objekt aus einem CTime anderen CTime Wert.
CTime( __time64_t ); Erstellt ein CTime Objekt aus einem __time64_t Typ. Dieser Konstruktor erwartet eine UTC-Zeit und konvertiert das Ergebnis in eine lokale Zeit, bevor das Ergebnis gespeichert wird.
CTime( int, int, ...); Erstellt ein CTime Objekt aus lokalen Zeitkomponenten, wobei jede Komponente auf die folgenden Bereiche beschränkt ist:

Komponente Bereich

nYear 1970-3000

nMonth 1-12

nDay 1-31

nHour 0-23

nMin 0-59

Nsec 0-59

Dieser Konstruktor macht die entsprechende Konvertierung in UTC. Die Debugversion der Microsoft Foundation-Klassenbibliothek bestätigt, ob eine oder mehrere Zeitkomponenten außerhalb des zulässigen Bereichs liegen. Sie müssen die Argumente vor dem Aufrufen überprüfen. Dieser Konstruktor erwartet eine lokale Zeit.
CTime( WORD, WORD ); Erstellt ein CTime Objekt aus den angegebenen MS-DOS-Datums- und Uhrzeitwerten. Dieser Konstruktor erwartet eine lokale Zeit.
CTime( const SYSTEMTIME& ); Erstellt ein CTime Objekt aus einer SYSTEMTIME Struktur. Dieser Konstruktor erwartet eine lokale Zeit.
CTime( const FILETIME& ); Erstellt ein CTime Objekt aus einer FILETIME Struktur. Wahrscheinlich wird die Initialisierung nicht direkt verwendet CTime FILETIME . Wenn Sie ein CFile Objekt verwenden, um eine Datei zu bearbeiten, ruft den Dateizeitstempel für Sie über ein CTime Objekt ab, CFile::GetStatus das mit einer FILETIME Struktur initialisiert wurde. Dieser Konstruktor setzt eine Zeit auf Der Grundlage von UTC voraus und konvertiert den Wert automatisch in lokale Zeit, bevor das Ergebnis gespeichert wird.

Hinweis

Der Konstruktor, DBTIMESTAMP der den Parameter verwendet, 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

Weitere Informationen finden Sie in der SYSTEMTIME- und FILETIME-Struktur im Windows SDK. Siehe auch den Eintrag "MS-DOS Date and Time " im 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

CTime::Format

Rufen Sie diese Memberfunktion auf, um eine formatierte Darstellung des Datums-/Uhrzeitwerts zu erstellen.

CString Format(LPCTSTR pszFormat) const;
CString Format(UINT nFormatID) const;

Parameter

pszFormat
Eine Formatierungszeichenfolge ähnlich der Formatierungszeichenfolge printf . Formatierungscodes, denen ein Prozentzeichen (%) vorangestellt ist, werden durch die entsprechende CTime Komponente ersetzt. Andere Zeichen in der Formatierungszeichenfolge werden unverändert in die zurückgegebene Zeichenfolge kopiert. Eine Liste der Formatierungscodes finden Sie in der Laufzeitfunktion strftime .

nFormatID
Die ID der Zeichenfolge, die dieses Format identifiziert.

Rückgabewert

Eine CString , die die formatierte Zeit enthält.

Hinweise

Wenn der Status dieses CTime Objekts null ist, ist der Rückgabewert eine leere Zeichenfolge.

Diese Methode löst eine Ausnahme aus, wenn der Datum-Uhrzeit-Wert im Format nicht zwischen Mitternacht, dem 1. Januar 1970 und dem 31. Dezember 3000 utc (Universal Coordinated Time) liegt.

Beispiel

CTime t(1999, 3, 19, 22, 15, 0); 
// 10:15 PM March 19, 1999
CString s = t.Format(_T("%A, %B %d, %Y"));
ATLASSERT(s == _T("Friday, March 19, 1999"));

CTime::FormatGmt

Generiert eine formatierte Zeichenfolge, die diesem CTime Objekt entspricht.

CString FormatGmt(LPCTSTR pszFormat) const;
CString FormatGmt(UINT nFormatID) const;

Parameter

pszFormat
Gibt eine Formatierungszeichenfolge an, die der Formatierungszeichenfolge printf ähnelt. Ausführliche Informationen finden Sie in der Laufzeitfunktion strftime .

nFormatID
Die ID der Zeichenfolge, die dieses Format identifiziert.

Rückgabewert

Eine CString , die die formatierte Zeit enthält.

Hinweise

Der Zeitwert wird nicht konvertiert und spiegelt somit UTC wider.

Diese Methode löst eine Ausnahme aus, wenn der Datum-Uhrzeit-Wert im Format nicht zwischen Mitternacht, dem 1. Januar 1970 und dem 31. Dezember 3000 utc (Universal Coordinated Time) liegt.

Beispiel

Sehen Sie sich das Beispiel für CTime::Format an.

CTime::GetAsDBTIMESTAMP

Rufen Sie diese Memberfunktion auf, um die im Objekt gespeicherten Zeitinformationen in CTime eine win32-kompatible DBTIMESTAMP-Struktur zu konvertieren.

bool GetAsDBTIMESTAMP(DBTIMESTAMP& dbts) const throw();

Parameter

dbts
Ein Verweis auf eine DBTIMESTAMP-Struktur, die die aktuelle Ortszeit enthält.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Speichert die resultierende Zeit in der Struktur für referenzierte Dbts . Die DBTIMESTAMP von dieser Funktion initialisierte Datenstruktur hat den fraction Member auf Null festgelegt.

Beispiel

CTime t = CTime::GetCurrentTime();
DBTIMESTAMP ts;
t.GetAsDBTIMESTAMP(ts); // Retrieves the time in t into the ts structure

CTime::GetAsSystemTime

Rufen Sie diese Memberfunktion auf, um die im Objekt gespeicherten Zeitinformationen in CTime eine win32-kompatible SYSTEMTIME-Struktur zu konvertieren.

bool GetAsSystemTime(SYSTEMTIME& st) const throw();

Parameter

timeDest
Ein Verweis auf eine SYSTEMTIME-Struktur , die den konvertierten Datums-/Uhrzeitwert des CTime Objekts enthält.

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

Hinweise

GetAsSystemTime speichert die resultierende Zeit in der referenzierten TimeDest-Struktur . Die SYSTEMTIME von dieser Funktion initialisierte Datenstruktur hat den wMilliseconds Member auf Null festgelegt.

Beispiel

// Convert CTime to FILETIME
CTime time(CTime::GetCurrentTime());
SYSTEMTIME timeDest;
time.GetAsSystemTime(timeDest);
FILETIME fileTime;
::SystemTimeToFileTime(&timeDest, &fileTime);

CTime::GetCurrentTime

Gibt ein CTime Objekt zurück, das die aktuelle Uhrzeit darstellt.

static CTime WINAPI GetCurrentTime() throw();

Hinweise

Gibt das aktuelle Systemdatum und die aktuelle Uhrzeit in koordinierter Weltzeit (COORDINATED Universal Time, UTC) zurück.

Beispiel

CTime t = CTime::GetCurrentTime();

CTime::GetDay

Gibt den Tag zurück, der CTime vom Objekt dargestellt wird.

int GetDay() const throw();

Rückgabewert

Gibt den Tag des Monats basierend auf der Ortszeit im Bereich 1 bis 31 zurück.

Hinweise

Diese Funktion ruft einen GetLocalTminternen, statisch zugeordneten Puffer auf. Die Daten in diesem Puffer werden aufgrund von Aufrufen anderer CTime Memberfunktionen überschrieben.

Beispiel

// Example for CTime::GetDay, CTime::GetMonth, and CTime::GetYear
CTime t(1999, 3, 19, 22, 15, 0); // 10:15 PM March 19, 1999
ATLASSERT(t.GetDay() == 19);
ATLASSERT(t.GetMonth() == 3);
ATLASSERT(t.GetYear() == 1999);

CTime::GetDayOfWeek

Gibt den Wochentag zurück, der durch das CTime Objekt dargestellt wird.

int GetDayOfWeek() const throw();

Rückgabewert

Gibt den Wochentag basierend auf der Ortszeit zurück. 1 = Sonntag, 2 = Montag, bis 7 = Samstag.

Hinweise

Diese Funktion ruft auf GetLocalTm, die einen internen statisch zugeordneten Puffer verwendet. Die Daten in diesem Puffer werden aufgrund von Aufrufen anderer CTime Memberfunktionen überschrieben.

Beispiel

// Print out the day of the week using localized day name
UINT DayOfWeek[] = {
   LOCALE_SDAYNAME7,   // Sunday
   LOCALE_SDAYNAME1,   
   LOCALE_SDAYNAME2,
   LOCALE_SDAYNAME3,
   LOCALE_SDAYNAME4, 
   LOCALE_SDAYNAME5, 
   LOCALE_SDAYNAME6   // Saturday
};
TCHAR strWeekday[256];
CTime time(CTime::GetCurrentTime());   // Initialize CTime with current time
::GetLocaleInfo(LOCALE_USER_DEFAULT,   // Get string for day of the week from system
   DayOfWeek[time.GetDayOfWeek()-1],   // Get day of week from CTime
   strWeekday, sizeof(strWeekday) / sizeof(strWeekday[0]));
ATLTRACE(_T("%s\n"), strWeekday);               // Print out day of the week

CTime::GetGmtTm

Ruft eine Struktur tm ab, die eine Analyse der Zeit enthält, die in diesem CTime Objekt enthalten ist.

struct tm* GetGmtTm(struct tm* ptm) const;

Parameter

ptm
Verweist auf einen Puffer, der die Zeitdaten empfängt. Wenn dieser Zeiger NULL ist, wird eine Ausnahme ausgelöst.

Rückgabewert

Ein Zeiger auf eine ausgefüllte Struktur tm gemäß definition in der Includedatei TIME.H. Siehe gmtime, _gmtime32, _gmtime64 für das Strukturlayout.

Hinweise

GetGmtTm gibt UTC zurück.

ptm kann nicht NULL sein. Wenn Sie das alte Verhalten wiederherstellen möchten, in dem ptm NULL sein könnte, um anzugeben, dass ein interner, statisch zugewiesener Puffer verwendet werden soll, und dann _SECURE_ATL.

Beispiel

// Compute difference between local time and GMT
CTime time(CTime::GetCurrentTime());
tm t1, t2;
time.GetLocalTm(&t1);
time.GetGmtTm(&t2);

ATLTRACE(_T("Difference between local time and GMT is %d hours.\n"), 
   t1.tm_hour - t2.tm_hour);

CTime::GetHour

Gibt die Stunde zurück, die durch das CTime Objekt dargestellt wird.

int GetHour() const throw();

Rückgabewert

Gibt die Stunde basierend auf der Ortszeit im Bereich 0 bis 23 zurück.

Hinweise

Beispiel

// Example for CTime::GetHour, CTime::GetMinute, and CTime::GetSecond
CTime t(1999, 3, 19, 22, 15, 0); // 10:15 PM March 19, 1999
ATLASSERT(t.GetSecond() == 0);
ATLASSERT(t.GetMinute() == 15);
ATLASSERT(t.GetHour() == 22);

CTime::GetLocalTm

Ruft eine Struktur tm ab, die eine Analyse der Zeit enthält, die in diesem CTime Objekt enthalten ist.

struct tm* GetLocalTm(struct tm* ptm) const;

Parameter

ptm
Verweist auf einen Puffer, der die Zeitdaten empfängt. Wenn dieser Zeiger NULL ist, wird eine Ausnahme ausgelöst.

Rückgabewert

Ein Zeiger auf eine ausgefüllte Struktur tm gemäß definition in der Includedatei TIME.H. Siehe gmtime, _gmtime32, _gmtime64 für das Strukturlayout.

Hinweise

GetLocalTm gibt die Ortszeit zurück.

Beispiel

CTime t(1999, 3, 19, 22, 15, 0); // 10:15PM March 19, 1999
tm osTime;  // A structure containing time elements.
t.GetLocalTm(&osTime);
ATLASSERT(osTime.tm_mon == 2); // Note zero-based month!

CTime::GetMinute

Gibt die Minute zurück, die durch das CTime Objekt dargestellt wird.

int GetMinute() const throw();

Rückgabewert

Gibt die Minute basierend auf der Ortszeit im Bereich 0 bis 59 zurück.

Hinweise

Beispiel

Sehen Sie sich das Beispiel für GetHour an.

CTime::GetMonth

Gibt den Monat zurück, der durch das CTime Objekt dargestellt wird.

int GetMonth() const throw();

Rückgabewert

Gibt den Monat basierend auf der Ortszeit im Bereich 1 bis 12 zurück (1 = Januar).

Hinweise

Beispiel

Sehen Sie sich das Beispiel für GetDay an.

CTime::GetSecond

Gibt die zweite vom CTime Objekt dargestellte Zurück.

int GetSecond() const throw();

Rückgabewert

Gibt die sekunde basierend auf der Ortszeit im Bereich 0 bis 59 zurück.

Hinweise

Beispiel

Sehen Sie sich das Beispiel für GetHour an.

CTime::GetTime

Gibt einen __time64_t Wert für das angegebene CTime Objekt zurück.

__time64_t GetTime() const throw();

Rückgabewert

GetTime gibt die Anzahl der Sekunden zwischen dem aktuellen CTime Objekt und dem 1. Januar 1970 zurück.

Beispiel

CTime t(2005, 10, 20, 23, 50, 0); // 11:50 PM October 20, 2005
time_t osBinaryTime = t.GetTime();  // time_t defined in <time.h>

_tprintf_s(_T("time_t = %ld\n"), osBinaryTime);

CTime::GetYear

Gibt das durch das CTime Objekt dargestellte Jahr zurück.

int GetYear();

Rückgabewert

Gibt das Jahr basierend auf der Ortszeit im Bereich vom 1. Januar 1970 bis zum 18. Januar 2038 (einschließlich) zurück.

Hinweise

Beispiel

Sehen Sie sich das Beispiel für GetDay an.

CTime::operator =

Der -Zuweisungsoperator.

CTime& operator=(__time64_t time) throw();

Parameter

time
Der neue Datums-/Uhrzeitwert.

Rückgabewert

Das aktualisierte CTime Objekt.

Hinweise

Dieser überladene Zuordnungsoperator kopiert die Quellzeit in dieses CTime Objekt. Der interne Zeitspeicher in einem CTime Objekt ist unabhängig von der Zeitzone. Die Zeitzonenkonvertierung ist während der Zuordnung nicht erforderlich.

CTime::operator +, -

Diese Operatoren addieren und subtrahieren CTimeSpan und CTime objekte.

CTime operator+(CTimeSpan timeSpan) const throw();
CTime operator-(CTimeSpan timeSpan) const throw();
CTimeSpan operator-(CTime time) const throw();

Parameter

timeSpan
Das CTimeSpan hinzuzufügende oder subtrahierte Objekt.

time
Das CTime objekt, das subtrahiert werden soll.

Rückgabewert

Ein CTime oder CTimeSpan ein Objekt, das das Ergebnis des Vorgangs darstellt.

Hinweise

CTime Objekte stellen absolute Zeit dar, CTimeSpan Objekte stellen relative Zeit dar. Mit den ersten beiden Operatoren können Sie Objekte zu und von Objekten addieren CTimeSpan und von CTime diesen subtrahieren. Mit dem dritten Operator können Sie ein Objekt von einem CTime anderen subtrahieren, um ein CTimeSpan Objekt zu erhalten.

Beispiel

CTime t1(1999, 3, 19, 22, 15, 0); // 10:15 PM March 19, 1999
CTime t2(1999, 3, 20, 22, 15, 0); // 10:15 PM March 20, 1999
CTimeSpan ts = t2 - t1;             // Subtract 2 CTimes
ATLASSERT(ts.GetTotalSeconds() == 86400L);
ATLASSERT((t1 + ts) == t2);       // Add a CTimeSpan to a CTime.
ATLASSERT((t2 - ts) == t1);       // Subtract a CTimeSpan from a CTime.

CTime::operator +=, -=

Diese Operatoren addieren und subtrahieren ein CTimeSpan Objekt zu und von diesem CTime Objekt.

CTime& operator+=(CTimeSpan span) throw();
CTime& operator-=(CTimeSpan span) throw();

Parameter

Spannweite
Das CTimeSpan hinzuzufügende oder subtrahierte Objekt.

Rückgabewert

Das aktualisierte CTime Objekt.

Hinweise

Mit diesen Operatoren können Sie ein CTimeSpan Objekt zu und von diesem CTime Objekt subtrahieren.

Beispiel

CTime t(1999, 3, 19, 22, 15, 0); // 10:15 PM March 19, 1999
t += CTimeSpan(0, 1, 0, 0);      // 1 hour exactly
ATLASSERT(t.GetHour() == 23);

CTime::Serialize64

Hinweis

Diese Methode ist nur in MFC-Projekten verfügbar.

Serialisiert die Daten, die der Membervariablen zugeordnet sind, in oder aus einem Archiv.

CArchive& Serialize64(CArchive& ar);

Parameter

Ar
Das CArchive Objekt, das Sie aktualisieren möchten.

Rückgabewert

Das aktualisierte CArchive Objekt.

Siehe auch

asctime_s, _wasctime_s
_ftime_s, _ftime32_s, _ftime64_s
gmtime_s, _gmtime32_s, _gmtime64_s
localtime_s, _localtime32_s, _localtime64_s
strftime, wcsftime, _strftime_l, _wcsftime_l
time, _time32, _time64
CTimeSpan-Klasse
Hierarchiediagramm
ATL/MFC Shared Classes

Freigeben über

CTime-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Operatoren

Hinweise

Anforderungen

CTime-Vergleichsoperatoren

Parameter

Rückgabewert

Beispiel

CTime::CTime

Parameter

Hinweise

Beispiel

CTime::Format

Parameter

Rückgabewert

Hinweise

Beispiel

CTime::FormatGmt

Parameter

Rückgabewert

Hinweise

Beispiel

CTime::GetAsDBTIMESTAMP

Parameter

Rückgabewert

Hinweise

Beispiel

CTime::GetAsSystemTime

Parameter

Rückgabewert

Hinweise

Beispiel

CTime::GetCurrentTime

Hinweise

Beispiel

CTime::GetDay

Rückgabewert

Hinweise

Beispiel

CTime::GetDayOfWeek

Rückgabewert

Hinweise

Beispiel

CTime::GetGmtTm

Parameter

Rückgabewert

Hinweise

Beispiel

CTime::GetHour

Rückgabewert

Hinweise

Beispiel

CTime::GetLocalTm

Parameter

Rückgabewert

Hinweise

Beispiel

CTime::GetMinute

Rückgabewert

Hinweise

Beispiel

CTime::GetMonth

Rückgabewert

Hinweise

Beispiel

CTime::GetSecond

Rückgabewert

Hinweise

Beispiel

CTime::GetTime

Rückgabewert

Beispiel

CTime::GetYear

Rückgabewert

Hinweise