FileTimeToDosDateTime 函数 (winbase.h)

将文件时间转换为 MS-DOS 日期和时间值。

语法

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

参数

[in] lpFileTime

指向 FILETIME 结构的指针,其中包含要转换为 MS-DOS 日期和时间格式的文件时间。

[out] lpFatDate

指向要接收 MS-DOS 日期的变量的指针。 日期是具有以下格式的打包值。

Bits 说明
0–4 月中的某一天 (1-31)
5–8 月份 (1 = 1 月,2 = 2 月,等等 )
9-15 从 1980 年算起的年份偏移量(加上 1980 得到实际年份)

[out] lpFatTime

指向要接收 MS-DOS 时间的变量的指针。 time 是具有以下格式的打包值。

Bits 说明
0–4 Second 除以 2
5–10 分钟 (0–59)
11–15 24 小时制 (0-23)

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

MS-DOS 日期格式只能表示 1980/1/1 到 2107/12/31 之间的日期;如果输入文件时间超出此范围,则此转换失败。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

DosDateTimeToFileTime

FileTimeToSystemTime

SystemTimeToFileTime

时间函数