f_Info函数

函数名：wj_获取文件详情 / f_Info

函数功能

获取指定文件夹下所有文件的详细信息，支持递归子目录搜索及文件类型筛选。返回文件路径、大小（KB）及最后修改时间。

参数规范

参数名	类型	必填	示例	特殊说明
folderPath	String	是	"C:\\Documents"	目标文件夹的完整路径
includeSubfolders	Boolean	否	TRUE	是否包含子目录，默认TRUE
searchPattern	String	否	`"*.txt	*.xlsx"`	文件类型过滤，支持多类型用`	分隔，默认.`

使用案例

3.1 获取文件夹所有文件详细信息

问题描述：获取指定目录下文件详细信息（含子目录） 公式演示：

=f_Info("D:\\Reports")

输出效果： 返回三列数据，分别为文件路径、大小（KB）、修改日期。

3.2 筛选指定类型文件详细信息

问题描述：只获取指定类型文件的详细信息 公式演示：

=f_Info("D:\\Reports", TRUE, "*.txt|*.xlsx")

输出效果： 仅返回符合筛选条件文件的详细信息列表。

3.3 不包含子目录文件

问题描述：仅列出当前目录文件详细信息 公式演示：

=f_Info("D:\\Reports", FALSE)

输出效果： 仅当前目录文件的详细信息。

技术说明

4.1 搜索逻辑

• 使用Directory.GetFiles结合SearchOption控制递归深度
• 支持多类型扩展名过滤（用|分割）

4.2 返回格式

• 返回二维数组，三列对应文件路径、大小（KB）、修改日期（格式yyyy-MM-dd HH:mm）
• 文件大小保留两位小数，单位KB

4.3 异常处理

错误场景	返回值
目录不存在	错误：目录不存在
其他异常	错误: 异常信息

扩展应用

6.1 文件管理

结合其他函数实现批量文件大小统计和日期筛选

6.2 数据分析

可配合Excel筛选、排序功能进行文件信息统计分析

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