如何在绑定的Google Apps Script中获取电子表格指定行多列值用于计算

核心原理 #

当你给自定义函数传入单行多列的单元格区域（如A2:D2）时，Google Sheets会自动将入参转换为二维数组，结构为[[第1列值, 第2列值, 第3列值...]]：

• 外层数组的元素对应选中的行，单行场景下只存在1个元素
• 内层数组的元素对应当前行中每一列的数值，索引从0开始计数
  你之前的代码仅支持传入单个数值，传入多列区域后input为数组类型，直接进行数值运算会返回无效结果，按以下方式修改即可。

代码实现示例 #

以下示例实现传入整行区域，读取前三列数值计算结果的逻辑，你可以根据自己的计算需求修改对应逻辑：

function testfunction(rowInput) {
  // 兼容单值输入场景
  if (!Array.isArray(rowInput)) {
    return rowInput * 100;
  }
  // 提取当前行的所有列值
  const colValues = rowInput[0];
  // 按需读取对应列的数值，索引0对应传入区域的第1列，以此类推
  const value1 = colValues[0] || 0;
  const value2 = colValues[1] || 0;
  const value3 = colValues[2] || 0;
  // 自定义计算逻辑，示例为三值求和后乘以100
  return (value1 + value2 + value3) * 100;
}

表格调用方法 #

在电子表格的目标单元格内直接输入公式=testfunction(A2:C2)即可传入A2到C2的整行数据进行计算，下拉公式即可批量应用到其他行。

轻量场景替代方案 #

如果需要传入的列数较少，也可以直接将多列值作为独立参数传入函数，无需处理数组：

function testfunction(val1, val2, val3 = 0) {
  return (val1 + val2 + val3) * 100;
}

调用时输入=testfunction(A2,B2,C2)即可。

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