Gsheet 函数参数 a1notation - Javascript

在使用 Google Sheets 的 API 进行数据读取或写入时，我们需要使用一种叫做 A1 表示法（A1 notation）的方法来表明数据的位置。A1 表示法是一种简单易用的表示法，也是 Google Sheets 内部常用的表示法。

A1 表示法的基本格式

A1 表示法由两部分组成：列字母和行数字，中间用一个蕾丝号分隔。例如，B4 表示第二列第四行的单元格，C1 表示第三列第一行的单元格。

使用 A1 表示法读取和写入单元格数据

在 Javascript 中，我们可以使用 gsheet 库来使用 A1 表示法进行单元格的读取和写入操作。

读取单元格数据的方法：

var sheet = SpreadsheetApp.getActiveSheet();
var cell = sheet.getRange('B4');
var value = cell.getValue();

写入单元格数据的方法：

var sheet = SpreadsheetApp.getActiveSheet();
var cell = sheet.getRange('C3');
cell.setValue('Hello, World!');

表示多个单元格

我们也可以使用 A1 表示法来表示一个单元格区域。例如，B4:C6 表示左上角为 B4，右下角为 C6 的区域。在 Javascript 中，我们可以使用 getRange() 方法来获取一个单元格区域。

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange('B4:C6');
var values = range.getValues();

上面的代码将会读取 B4:C6 区域所有单元格的值，以一个二维数组的形式返回。

使用 A1 表示法指定整个行或整个列

在 A1 表示法中，为了指定整个行或整个列，我们可以使用数字 1 表示第一行或第一列。例如，A:A 表示第一列的所有单元格，3:3 表示第三行的所有单元格。

var sheet = SpreadsheetApp.getActiveSheet();
var column = sheet.getRange('A:A');
var values = column.getValues();

上面的代码将会读取 A 列中所有单元格的值。

总结

A1 表示法是 Google Sheets 中一个非常方便的位置表示方法。我们可以使用 A1 表示法来读取、写入单个单元格或单元格区域，也可以使用 A1 表示法来指定整行或整列。在 Javascript 中，通过 gsheet 库可以方便地使用 A1 表示法进行数据读写。