f_ModificationTime函数

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

函数功能

获取指定文件的最后修改时间，方便文件管理和版本控制。

参数规范

参数名	类型	必填	示例	特殊说明
filePath	String	是	"C:\Temp\example.txt"	支持绝对或相对路径

使用案例

3.1 获取文件修改时间

问题描述：查询文件最近一次被修改的时间 公式演示：

=f_ModificationTime("C:\Temp\data.txt")

输出效果（示例）：

2025-07-18 14:32:05

3.2 文件不存在时返回默认值

问题描述：检测文件是否存在，不存在时返回默认时间 公式演示：

=f_ModificationTime("C:\Temp\nofile.txt")

输出效果：

1899-12-30 00:00:00

技术说明

4.1 时间格式说明

• 返回类型为 DateTime
• 返回时间格式受Excel日期时间格式控制，可自定义显示格式

4.2 异常处理

错误场景	返回值
文件不存在	返回 DateTime.MinValue，即1899-12-30 00:00:00（Excel日期起点）

扩展应用

6.1 文件变更监控

结合条件格式或宏定期检测文件修改时间，提醒文件更新。

6.2 版本管理

通过比较文件修改时间实现版本判断和备份策略。

注：本函数在WPS 2019+和Excel 365中测试通过