FileTimeToDosDateTime-Funktion (winbase.h)

  • Artikel

Konvertiert eine Dateizeit in MS-DOS-Datums- und Uhrzeitwerte.

Syntax

BOOL FileTimeToDosDateTime(
  [in]  const FILETIME *lpFileTime,
  [out] LPWORD         lpFatDate,
  [out] LPWORD         lpFatTime
);

Parameter

[in] lpFileTime

Ein Zeiger auf eine FILETIME-Struktur , die die Dateizeit enthält, die in das MS-DOS-Datums- und Uhrzeitformat konvertiert werden soll.

[out] lpFatDate

Ein Zeiger auf eine Variable zum Empfangen des MS-DOS-Datums. Das Datum ist ein gepackter Wert im folgenden Format.

Bits BESCHREIBUNG
0–4 Tag des Monats (1–31)
5–8 Monat (1 = Januar, 2 = Februar usw.)
9–15 Jahresversatz von 1980 (1980 addieren, um das tatsächliche Jahr zu erhalten)

[out] lpFatTime

Ein Zeiger auf eine Variable zum Empfangen der MS-DOS-Zeit. Die Zeit ist ein gepackter Wert mit dem folgenden Format.

Bits BESCHREIBUNG
0–4 Zweiter geteilt durch 2
5–10 Minute (0–59)
11–15 Stunde (0–23 auf einer 24-Stunden-Uhr)

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Das MS-DOS-Datumsformat kann nur Datumsangaben zwischen dem 1.1.1980 und dem 31.12.2107 darstellen. Diese Konvertierung schlägt fehl, wenn die Zeit der Eingabedatei außerhalb dieses Bereichs liegt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTimeTime

Zeitfunktionen