CFileTime-Klasse
Diese Klasse stellt Methoden zum Verwalten der Datums- und Uhrzeitwerte bereit, die einer Datei zugeordnet sind.
Syntax
class CFileTime : public FILETIME
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
CFileTime::CFileTime |
Der Konstruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
CFileTime::GetCurrentTime |
Rufen Sie diese statische Funktion auf, um ein CFileTime Objekt abzurufen, das das aktuelle Systemdatum und die aktuelle Uhrzeit darstellt. |
CFileTime::GetTime |
Rufen Sie diese Methode auf, um die Zeit aus dem CFileTime Objekt abzurufen. |
CFileTime::LocalToUTC |
Rufen Sie diese Methode auf, um eine lokale Dateizeit basierend auf der koordinierten Weltzeit (UTC) in eine Dateizeit zu konvertieren. |
CFileTime::SetTime |
Rufen Sie diese Methode auf, um das datum und die Uhrzeit festzulegen, die vom CFileTime Objekt gespeichert sind. |
CFileTime::UTCToLocal |
Rufen Sie diese Methode auf, um die Zeit basierend auf der koordinierten Weltzeit (COORDINATED Universal Time, UTC) in lokale Dateizeit zu konvertieren. |
Öffentliche Operatoren
| Name | Beschreibung |
|---|---|
CFileTime::operator - |
Dieser Operator wird verwendet, um Subtraktion für ein CFileTime Oder CFileTimeSpan Objekt auszuführen. |
CFileTime::operator != |
Dieser Operator vergleicht zwei CFileTime Objekte für Ungleichheiten. |
CFileTime::operator + |
Dieser Operator wird verwendet, um Addition für ein CFileTimeSpan-Objekt auszuführen. |
CFileTime::operator += |
Dieser Operator wird verwendet, um Addition für ein CFileTimeSpan-Objekt auszuführen und das Ergebnis dem aktuellen Objekt zuzuweisen. |
CFileTime::operator < |
Dieser Operator vergleicht zwei CFileTime-Objekte, um das kleinere zu bestimmen. |
CFileTime::operator <= |
Dieser Operator vergleicht zwei CFileTime-Objekte, um zu bestimmen, ob sie gleich sind oder welches kleiner ist. |
CFileTime::operator = |
Der -Zuweisungsoperator. |
CFileTime::operator -= |
Dieser Operator wird verwendet, um Subtraktion für ein CFileTimeSpan Objekt auszuführen und das Ergebnis dem aktuellen Objekt zuzuweisen. |
CFileTime::operator == |
Dieser Operator überprüft zwei CFileTime-Objekte auf Gleichheit. |
CFileTime::operator > |
Dieser Operator vergleicht zwei CFileTime-Objekte, um das größere zu bestimmen. |
CFileTime::operator >= |
Dieser Operator vergleicht zwei CFileTime-Objekte, um zu bestimmen, ob sie gleich sind oder welches größer ist. |
Öffentliche Konstanten
| Name | Beschreibung |
|---|---|
CFileTime::Day |
Ein statisches Datenelement, das die Anzahl von 100-Nanosekundenintervallen speichert, die einen Tag bilden. |
CFileTime::Hour |
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Stunde bilden. |
CFileTime::Millisecond |
Ein statisches Datenmember, das die Anzahl von 100-Nanosekunden-Intervallen speichert, die eine Millisekunden bilden. |
CFileTime::Minute |
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Minute bilden. |
CFileTime::Second |
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Sekunde bilden. |
CFileTime::Week |
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Woche bilden. |
Hinweise
Diese Klasse stellt Methoden zum Verwalten der Datums- und Uhrzeitwerte bereit, die mit der Erstellung, dem Zugriff und der Änderung von Dateien verknüpft sind. Die Methoden und Daten dieser Klasse werden häufig zusammen mit CFileTimeSpan Objekten verwendet, die sich mit relativen Zeitwerten befassen.
Der Datums- und Uhrzeitwert wird als 64-Bit-Wert gespeichert, der die Anzahl der Intervalle von 100 Nanosekunden seit dem 1. Januar 1601 darstellt. Dieses Format ist das UTC-Format (Coordinated Universal Time).
Die folgenden statischen Konstantenmememmvariablen werden bereitgestellt, um Berechnungen zu vereinfachen:
| Membervariable | Anzahl der Intervalle von 100 Nanosekunden |
|---|---|
| Millisekunde | 10.000 |
| Sekunde | Millisekunden * 1.000 |
| Minute | Second * 60 |
| Stunde | Minute * 60 |
| Tag | Stunde * 24 |
| Woche | Tag * 7 |
Hinweis
Nicht alle Dateisysteme können erstellungs- und zeitpunkt des letzten Zugriffs aufzeichnen, und nicht alle Dateisysteme zeichnen sie auf die gleiche Weise auf. Beispielsweise hat die Erstellungszeit im Windows NT FAT-Dateisystem eine Auflösung von 10 Millisekunden, die Schreibzeit hat eine Auflösung von 2 Sekunden, und die Zugriffszeit hat eine Auflösung von 1 Tag (das Zugriffsdatum). Bei NTFS hat die Zugriffszeit eine Auflösung von 1 Stunde. Darüber hinaus zeichnet FAT Zeiten auf dem Datenträger in der lokalen Zeit auf, aber NTFS zeichnet Zeiten auf dem Datenträger in UTC auf. Weitere Informationen finden Sie unter "Dateizeiten".
Vererbungshierarchie
Anforderungen
Kopfzeile: atltime.h
CFileTime::CFileTime
Der Konstruktor.
CFileTime() throw();
CFileTime(const FILETIME& ft) throw();
CFileTime(ULONGLONG nTime) throw();
Parameter
ft
Eine FILETIME-Struktur.
nTime
Das Datum und die Uhrzeit, die als 64-Bit-Wert ausgedrückt wird.
Hinweise
Das CFileTime Objekt kann mithilfe eines vorhandenen Datums und einer vorhandenen Uhrzeit aus einer FILETIME Struktur erstellt oder als 64-Bit-Wert (in lokalen oder utc-Zeitformaten) ausgedrückt werden. Der Standardkonstruktor legt die Zeit auf 0 fest.
CFileTime::Day
Ein statisches Datenelement, das die Anzahl von 100-Nanosekundenintervallen speichert, die einen Tag bilden.
static const ULONGLONG Day = Hour* 24;
Beispiel
Sehen Sie sich das Beispiel für CFileTime::Millisecond.
CFileTime::GetCurrentTime
Rufen Sie diese statische Funktion auf, um ein CFileTime Objekt abzurufen, das das aktuelle Systemdatum und die aktuelle Uhrzeit darstellt.
static CFileTime GetCurrentTime() throw();
Rückgabewert
Gibt das aktuelle Systemdatum und die aktuelle Uhrzeit im UTC-Format (Coordinated Universal Time) zurück.
Beispiel
// Retrieve the current time
CFileTime myFT;
myFT = CFileTime::GetCurrentTime();
CFileTime::GetTime
Rufen Sie diese Methode auf, um die Zeit aus dem CFileTime Objekt abzurufen.
ULONGLONG GetTime() const throw();
Rückgabewert
Gibt das Datum und die Uhrzeit als 64-Bit-Zahl zurück, die sich entweder im lokalen oder koordinierten Weltzeitformat (UTC) befinden kann.
CFileTime::Hour
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Stunde bilden.
static const ULONGLONG Hour = Minute* 60;
Beispiel
Sehen Sie sich das Beispiel für CFileTime::Millisecond.
CFileTime::LocalToUTC
Rufen Sie diese Methode auf, um eine lokale Dateizeit basierend auf der koordinierten Weltzeit (UTC) in eine Dateizeit zu konvertieren.
CFileTime LocalToUTC() const throw();
Rückgabewert
Gibt ein CFileTime Objekt zurück, das die Uhrzeit im UTC-Format enthält.
Beispiel
Sehen Sie sich das Beispiel für CFileTime::UTCToLocal.
CFileTime::Millisecond
Ein statisches Datenmember, das die Anzahl von 100-Nanosekunden-Intervallen speichert, die eine Millisekunden bilden.
static const ULONGLONG Millisecond = 10000;
Beispiel
// Calculate the difference between two times
CFileTime myFT1, myFT2;
CFileTimeSpan myFTS;
// Get the first time
myFT1 = CFileTime::GetCurrentTime();
// Pause for a moment
UINT randVal;
rand_s(&randVal);
Sleep(randVal % 10000);
// Get the second time
myFT2 = CFileTime::GetCurrentTime();
// Calculate the time difference
myFTS = myFT2 - myFT1;
// Measure the difference
if (myFTS.GetTimeSpan() < CFileTime::Minute)
printf_s("Less than a minute passed\n");
else
printf_s("A minute or more passed\n");
if (myFTS.GetTimeSpan() < CFileTime::Second)
printf_s("Less than a second passed\n");
else
printf_s("A second or more passed\n");
if (myFTS.GetTimeSpan() < CFileTime::Millisecond)
printf_s("Less than a millisecond passed\n");
else
printf_s("A millisecond or more passed\n");
CFileTime::Minute
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Minute bilden.
static const ULONGLONG Minute = Second* 60;
Beispiel
Sehen Sie sich das Beispiel für CFileTime::Millisecond.
CFileTime::operator -
Dieser Operator wird verwendet, um Subtraktion für ein CFileTime Oder CFileTimeSpan Objekt auszuführen.
CFileTime operator-(CFileTimeSpan span) const throw();
CFileTimeSpan operator-(CFileTime ft) const throw();
Parameter
span
Ein CFileTimeSpan-Objekt.
ft
Ein CFileTime-Objekt.
Rückgabewert
Gibt ein CFileTime Objekt oder ein CFileTimeSpan Objekt zurück, das das Ergebnis der Zeitdifferenz zwischen den beiden Objekten darstellt.
CFileTime::operator !=
Dieser Operator vergleicht zwei CFileTime Objekte für Ungleichheiten.
bool operator!=(CFileTime ft) const throw();
Parameter
ft
Das zu vergleichende CFileTime-Objekt.
Rückgabewert
Gibt zurück TRUE , wenn das verglichene Element nicht dem Objekt entspricht CFileTime , andernfalls FALSE.
CFileTime::operator +
Dieser Operator wird verwendet, um Addition für ein CFileTimeSpan-Objekt auszuführen.
CFileTime operator+(CFileTimeSpan span) const throw();
Parameter
span
Ein CFileTimeSpan-Objekt.
Rückgabewert
Gibt ein CFileTime Objekt zurück, das das Ergebnis der ursprünglichen Uhrzeit und eine relative Zeit darstellt.
CFileTime::operator +=
Dieser Operator wird verwendet, um Addition für ein CFileTimeSpan-Objekt auszuführen und das Ergebnis dem aktuellen Objekt zuzuweisen.
CFileTime& operator+=(CFileTimeSpan span) throw();
Parameter
span
Ein CFileTimeSpan-Objekt.
Rückgabewert
Gibt das aktualisierte CFileTime Objekt zurück, das das Ergebnis der ursprünglichen Uhrzeit plus einer relativen Zeit darstellt.
CFileTime::operator <
Dieser Operator vergleicht zwei CFileTime-Objekte, um das kleinere zu bestimmen.
bool operator<(CFileTime ft) const throw();
Parameter
ft
Das zu vergleichende CFileTime-Objekt.
Rückgabewert
Gibt zurück TRUE , wenn das erste Objekt kleiner (früher in der Zeit) als die zweite ist, FALSE andernfalls.
Beispiel
// Test for one time less than another
// Declare the CFileType objects
CFileTime myFT1, myFT2;
// Obtain the first time value
myFT1 = CFileTime::GetCurrentTime();
// Pause for a moment...
Sleep(1000);
// Obtain the second time value
myFT2 = CFileTime::GetCurrentTime();
// Perform the comparison
if (myFT1 < myFT2)
_tprintf_s(_T("Time is going in the correct direction.\n"));
else
_tprintf_s(_T("Oh dear. Time is going backwards.\n"));
CFileTime::operator <>=
Dieser Operator vergleicht zwei CFileTime-Objekte, um zu bestimmen, ob sie gleich sind oder welches kleiner ist.
bool operator<=(CFileTime ft) const throw();
Parameter
ft
Das zu vergleichende CFileTime-Objekt.
Rückgabewert
Gibt zurück TRUE , wenn das erste Objekt kleiner als (früher in der Zeit) oder gleich der zweiten ist, andernfalls FALSE.
CFileTime::operator =
Der -Zuweisungsoperator.
CFileTime& operator=(const FILETIME& ft) throw();
Parameter
ft
Ein CFileTime Objekt, das die neue Uhrzeit und das neue Datum enthält.
Rückgabewert
Gibt das aktualisierte Objekt zurück CFileTime .
CFileTime::operator -=
Dieser Operator wird verwendet, um Subtraktion für ein CFileTimeSpan Objekt auszuführen und das Ergebnis dem aktuellen Objekt zuzuweisen.
CFileTime& operator-=(CFileTimeSpan span) throw();
Parameter
span
Ein CFileTimeSpan Objekt, das die relative Zeit zum Subtrahieren enthält.
Rückgabewert
Gibt das aktualisierte Objekt zurück CFileTime .
CFileTime::operator ==
Dieser Operator überprüft zwei CFileTime-Objekte auf Gleichheit.
bool operator==(CFileTime ft) const throw();
Parameter
ft
Das zu vergleichende CFileTime-Objekt.
Rückgabewert
Gibt TRUE zurück, wenn die Objekte gleich sind, andernfalls ist der Wert FALSE.
CFileTime::operator >
Dieser Operator vergleicht zwei CFileTime-Objekte, um das größere zu bestimmen.
bool operator>(CFileTime ft) const throw();
Parameter
ft
Das zu vergleichende CFileTime-Objekt.
Rückgabewert
Gibt zurück TRUE , wenn das erste Objekt größer als (später) als die zweite ist, andernfalls FALSE.
CFileTime::operator >=
Dieser Operator vergleicht zwei CFileTime-Objekte, um zu bestimmen, ob sie gleich sind oder welches größer ist.
bool operator>=(CFileTime ft) const throw();
Parameter
ft
Das zu vergleichende CFileTime-Objekt.
Rückgabewert
Gibt zurück TRUE , wenn das erste Objekt größer als (später) oder gleich der zweiten ist, andernfalls FALSE.
CFileTime::Second
Ein statisches Datenelement, das die Anzahl von 100-Nanosekundenintervallen speichert, die einen Tag bilden.
static const ULONGLONG Second = Millisecond* 1000;
Beispiel
Sehen Sie sich das Beispiel für CFileTime::Millisecond.
CFileTime::SetTime
Rufen Sie diese Methode auf, um das datum und die Uhrzeit festzulegen, die vom CFileTime Objekt gespeichert sind.
void SetTime(ULONGLONG nTime) throw();
Parameter
nTime
Der 64-Bit-Wert, der Datum und Uhrzeit im lokalen oder koordinierten Weltzeitformat (UTC) darstellt.
CFileTime::UTCToLocal
Rufen Sie diese Methode auf, um die Zeit basierend auf der koordinierten Weltzeit (COORDINATED Universal Time, UTC) in lokale Dateizeit zu konvertieren.
CFileTime UTCToLocal() const throw();
Rückgabewert
Gibt ein CFileTime Objekt zurück, das die Uhrzeit im lokalen Dateiformat enthält.
Beispiel
// Convert a UTC time to local file time format
CFileTime myUTC_FT, myL_FT;
// Get system time (in UTC format)
myUTC_FT = CFileTime::GetCurrentTime();
// Convert to local file time
myL_FT = myUTC_FT.UTCToLocal();
CFileTime::Week
Ein statisches Datenmember, das die Anzahl von 100-Nanosekundenintervallen speichert, die eine Woche bilden.
static const ULONGLONG Week = Day* 7;
Beispiel
Sehen Sie sich das Beispiel für CFileTime::Millisecond.
Siehe auch
FILETIME
CFileTimeSpan-Klasse
Hierarchiediagramm
FREIGEGEBENe ATL/MFC-Klassen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für