获取文件最后修改时间

函数名：f_文件修改时间 / f_ModificationTime

功能描述

获取指定文件的最后修改时间，返回 DateTime 类型的日期时间值。

会员等级：🟢 免费版（Free）

语法

=f_文件修改时间(文件路径)

参数

参数名	类型	必填	默认值	说明
文件路径	String	是	无	待检查文件的完整路径

返回值

DateTime - 文件的最后修改时间。文件不存在时返回 DateTime.MinValue（在 Excel 中显示为 1900-01-00 00:00:00，即日期序列号 0）。

使用示例

获取文件修改时间

公式：

=f_文件修改时间("C:\Temp\data.txt")

结果：

2025-07-18 14:32:05

文件不存在

公式：

=f_文件修改时间("C:\Temp\nofile.txt")

结果：

1900-01-00 00:00:00

格式化输出修改时间

公式：

=TEXT(f_文件修改时间("C:\Temp\data.txt"), "yyyy-MM-dd HH:mm:ss")

结果：

2025-07-18 14:32:05

技术说明

• 先通过 File.Exists 检查文件是否存在，不存在则返回 DateTime.MinValue。
• 文件存在时调用 File.GetLastWriteTime 获取最后写入时间。
• 返回类型为 DateTime，Excel 会自动按日期格式显示，可通过单元格格式或 TEXT 函数自定义显示格式。

错误处理

错误场景	返回值
文件不存在	DateTime.MinValue（Excel 日期序列号 0）
文件存在	文件最后修改时间（DateTime）