如何用Excel Office Script获取表格数据列的最小/最大值

不用循环也能高效实现，推荐两种更简洁的方法：

方法1：直接调用Excel内置统计函数（最优） #

Office Script提供了直接调用Excel原生函数的能力，完全不用自己处理数组，让Excel帮你计算统计值，这是最省心高效的方式，还会自动忽略空单元格和非数值内容，完美适配你的场景。

示例代码（以最小值、最大值、平均值为例）：

function main(workbook: ExcelScript.Workbook) {
  const table = workbook.getTable("YourTableName"); // 替换为你的表格名称
  const columnRange = table.getColumnByName("myColumn").getRange(); // 目标列的单元格范围

  const minValue = workbook.functions.min(columnRange);
  const maxValue = workbook.functions.max(columnRange);
  const averageValue = workbook.functions.average(columnRange);

  console.log(`最小值: ${minValue}, 最大值: ${maxValue}, 平均值: ${averageValue}`);
}

方法2：处理数组后用JS原生方法计算 #

如果需要手动处理数据，解决之前遇到的类型和数组结构问题：

1. getValues()返回的是二维数组（即使单列也是[[num1], [num2], ...]），需要先转成一维数组
2. 过滤出纯数值（排除空值、字符串等非数值类型）

示例代码：

function main(workbook: ExcelScript.Workbook) {
  const table = workbook.getTable("YourTableName");
  const columnValues = table.getColumnByName("myColumn").getRange().getValues();
  
  // 转换为一维数组并过滤有效数值
  const validNumbers = columnValues.reduce((acc, row) => {
    const val = row[0];
    if (typeof val === 'number' && !isNaN(val)) {
      acc.push(val);
    }
    return acc;
  }, [] as number[]);

  if (validNumbers.length === 0) {
    console.log("该列无有效数值");
    return;
  }

  const minVal = Math.min(...validNumbers);
  const maxVal = Math.max(...validNumbers);
  console.log(`最小值: ${minVal}, 最大值: ${maxVal}`);
}

如果你的环境支持数组flat()方法，也可以把转换一维数组的部分简化为：

const validNumbers = columnValues.flat().filter(val => typeof val === 'number' && !isNaN(val)) as number[];

（注：若提示flat()不存在，是部分旧版Office Script的TypeScript支持问题，用reduce的方式兼容性更好）

内容的提问来源于stack exchange，提问作者FunThomas