Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Converts a file time to MS-DOS date and time values.
Syntax
BOOL FileTimeToDosDateTime(
[in] const FILETIME *lpFileTime,
[out] LPWORD lpFatDate,
[out] LPWORD lpFatTime
);
Parameters
[in] lpFileTime
A pointer to a FILETIME structure containing the file time to convert to MS-DOS date and time format.
[out] lpFatDate
A pointer to a variable to receive the MS-DOS date. The date is a packed value with the following format.
| Bits | Description |
|---|---|
| 0–4 | Day of the month (1–31) |
| 5–8 | Month (1 = January, 2 = February, etc.) |
| 9-15 | Year offset from 1980 (add 1980 to get actual year) |
[out] lpFatTime
A pointer to a variable to receive the MS-DOS time. The time is a packed value with the following format.
| Bits | Description |
|---|---|
| 0–4 | Second divided by 2 |
| 5–10 | Minute (0–59) |
| 11–15 | Hour (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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winbase.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |