如何编写Office Script函数返回含邮箱与两个行范围数组的多维数组

实现思路 #

要生成目标格式的多维数组，只需完成三步：定义邮箱字符串、读取Excel中指定行的单元格数据、将三者组合成符合结构的数组。

代码示例 #

function main(workbook: ExcelScript.Workbook): (string | string[][])[][] {
  // 自定义邮箱地址
  const targetEmail = "anymail@mail.com";
  // 替换为实际使用的工作表名称
  const targetSheet = workbook.getWorksheet("Sheet1");

  // 读取第一目标行的范围（示例对应A1:E1，可根据实际调整）
  const firstRowRange = targetSheet.getRange("A1:E1");
  const firstRowData = firstRowRange.getValues() as string[][];

  // 读取第二目标行的范围（示例对应A2:E2，可根据实际调整）
  const secondRowRange = targetSheet.getRange("A2:E2");
  const secondRowData = secondRowRange.getValues() as string[][];

  // 组合成要求的多维数组结构
  const finalResult = [[targetEmail], ...firstRowData, ...secondRowData];
  return finalResult;
}

关键说明 #

• 工作表与范围调整：将代码中的"Sheet1"替换为你的工作表名称，同时修改行范围地址（如目标行是第5、6行，就改成"A5:E5"和"A6:E6"）
• 动态范围适配：如果行的列数不固定，可改用targetSheet.getRange("1:1").getUsedRange()来动态获取整行的已用单元格
• 类型处理：若单元格包含数字、日期等非字符串类型，可通过value.toString()转换为字符串，确保数组元素类型统一

内容的提问来源于stack exchange，提问作者David Ricardo Menacho Vadillo