灵析表格

Appearance

json_TableToJson函数 ​

函数名：json_表格转Json / json_TableToJson

函数功能 ​

将包含标题行的表格区域数据转换为格式化的JSON数组字符串，支持将结果直接写入指定文件路径。

参数规范 ​

参数名类型必填示例特殊说明
tableDataObject[,]是{ {"姓名","年龄"}, {"张三",30}, {"李四",25} }包含标题行的二维表格数据区域
filepathString否"C:\\temp\\output.json"为空时返回JSON字符串，非空时写入文件

使用案例 ​

转换并返回JSON字符串 ​

问题描述：将Excel表格数据转换为JSON字符串 公式演示：

excel
=json_TableToJson(A1:C3, "")

输出效果：

json
[
  {
    "姓名": "张三",
    "年龄": 30
  },
  {
    "姓名": "李四",
    "年龄": 25
  }
]

转换并写入文件 ​

问题描述：将Excel表格数据转换后保存为JSON文件 公式演示：

excel
=json_TableToJson(A1:C3, "D:\\data\\output.json")

输出效果：

text
写入完成

技术说明 ​

  • 第一行作为JSON对象的键名
  • 自动识别数字格式，文本保持字符串格式
  • 空值自动转换为JSON中的null
  • 支持将JSON字符串写入指定文件路径
  • 异常捕获并返回错误信息

异常处理 ​

错误场景返回值
表格行数少于2（无数据行）错误：至少需要一行标题和一行数据
其他异常错误：异常信息

扩展应用 ​

与其他JSON函数配合 ​

生成JSON后，可直接调用json_数组转表格等函数，实现Excel与JSON间的双向数据转换。

批量导出数据 ​

结合Excel宏或批量公式，可快速生成多个JSON文件，实现数据导出自动化。

注：本函数已在WPS 2019+和Excel 365中测试通过，支持常见表格数据格式及多类型数据。