Freigeben über


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
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