FileTimeToDosDateTime function

Converts a file time to MS-DOS date and time values.

Syntax


BOOL WINAPI FileTimeToDosDateTime(
  _In_   const FILETIME *lpFileTime,
  _Out_  LPWORD lpFatDate,
  _Out_  LPWORD lpFatTime
);

Parameters

lpFileTime [in]

A pointer to a FILETIME structure containing the file time to convert to MS-DOS date and time format.

lpFatDate [out]

A pointer to a variable to receive the MS-DOS date. The date is a packed value with the following format.

BitsDescription
0–4Day of the month (1–31)
5–8Month (1 = January, 2 = February, etc.)
9-15Year offset from 1980 (add 1980 to get actual year)

 

lpFatTime [out]

A pointer to a variable to receive the MS-DOS time. The time is a packed value with the following format.

BitsDescription
0–4Second divided by 2
5–10Minute (0–59)
11–15Hour (0–23 on a 24-hour clock)

 

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The MS-DOS date format can represent only dates between 1/1/1980 and 12/31/2107; this conversion fails if the input file time is outside this range.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winbase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

DosDateTimeToFileTime
FileTimeToSystemTime
SystemTimeToFileTime
Time Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft