`CFileTime`-Klasse

Artikel
10/12/2023

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
Second	Millisekunden * 1.000
Minute	Second * 60
Hour	Minute * 60
Tag	Stunde * 24
Week	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

FILETIME
└ CFileTime

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

Ein Beispiel hierfür finden Sie unter 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

Ein Beispiel hierfür finden Sie unter 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

Ein Beispiel hierfür finden Sie unter 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

Ein Beispiel hierfür finden Sie unter 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

Ein Beispiel hierfür finden Sie unter 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

Ein Beispiel hierfür finden Sie unter CFileTime::Millisecond.

Siehe auch

FILETIME
CFileTimeSpan-Klasse
Hierarchiediagramm
FREIGEGEBENe ATL/MFC-Klassen

Freigeben über

CFileTime-Klasse

Syntax

Member

Öffentliche Konstruktoren

Öffentliche Methoden

Öffentliche Operatoren

Öffentliche Konstanten

Hinweise

Vererbungshierarchie

Anforderungen

CFileTime::CFileTime

Parameter

Hinweise

CFileTime::Day

Beispiel

CFileTime::GetCurrentTime

Rückgabewert

Beispiel

CFileTime::GetTime

Rückgabewert

CFileTime::Hour

Beispiel

CFileTime::LocalToUTC

Rückgabewert

Beispiel

CFileTime::Millisecond

Beispiel

CFileTime::Minute

Beispiel

CFileTime::operator -

Parameter

Rückgabewert

CFileTime::operator !=

Parameter

Rückgabewert

CFileTime::operator +

Parameter

Rückgabewert

CFileTime::operator +=

Parameter

Rückgabewert

CFileTime::operator <

Parameter

Rückgabewert

Beispiel

CFileTime::operator <>=

Parameter

Rückgabewert

CFileTime::operator =

Parameter

Rückgabewert

CFileTime::operator -=

Parameter

Rückgabewert

CFileTime::operator ==

Parameter

Rückgabewert

CFileTime::operator >

Parameter

Rückgabewert

CFileTime::operator >=

Parameter

Rückgabewert

CFileTime::Second

Beispiel

CFileTime::SetTime

Parameter

CFileTime::UTCToLocal

Rückgabewert

Beispiel

CFileTime::Week

Beispiel

Siehe auch

Feedback

Zusätzliche Ressourcen

`CFileTime`-Klasse

`CFileTime::CFileTime`

`CFileTime::Day`

`CFileTime::GetCurrentTime`

`CFileTime::GetTime`

`CFileTime::Hour`

`CFileTime::LocalToUTC`

`CFileTime::Millisecond`

`CFileTime::Minute`

`CFileTime::operator -`

`CFileTime::operator !=`

`CFileTime::operator +`

`CFileTime::operator +=`

`CFileTime::operator <`

`CFileTime::operator <>=`

`CFileTime::operator =`

`CFileTime::operator -=`

`CFileTime::operator ==`

`CFileTime::operator >`

`CFileTime::operator >=`

`CFileTime::Second`

`CFileTime::SetTime`

`CFileTime::UTCToLocal`

`CFileTime::Week`