读取和写入指定单元格的内容。

读取内容

读取单个单元格的值

getValue()

返回单个单元格的值，这个值可以是任意类型：数值、布尔值、日期或者字符串，类型取决于单元格的内容。如果是空的内容会返回一个空的字符串。即使选择了一个范围的单元格，也只会返回左上角第一个单元格的值。代码示例：

SpreadsheetApp.getActiveSheet().getRange('B3').getValue()

返回表格中对应位置的值

读取单元格范围的内容

getValues()

允许获取一个范围的内容，返回的结果是一个二维数组。代码示例：

SpreadsheetApp.getActiveSheet().getRange('A1:B3').getValues()

返回结果如下

[[35, 17], [23, 7], [15, 'A']]

写入内容

向单个单元格写入内容

setValue(value)

value 放入需要写入的内容。代码示例：

SpreadsheetApp.getActiveSheet().getRange('A1').setValue(4)

运行后会在 A1 单元格写入数值 4。

写入单元格范围的内容

setValues(values)

values 放入对应范围尺寸的二维数组。代码示例：

SpreadsheetApp.getActiveSheet().getRange('A1:A3').setValues([[1], [2], [3]])

获取 A1 到 A3 的单元格范围，然后写入 1，2，3 数值。

复制内容

copyTo(destination)

在使用 copyTo 之前需要先获取一个范围，然后在 destination 放入需要写入内容的范围。注意，这个方法不仅复制单元格的内容，还会复制单元的格式。代码示例：

const origRange = SpreadsheetApp.getActiveSheet().getRange('C:C')
const newRange = SpreadsheetApp.getActiveSheet().getRange('G:G')
origRange.copyTo(newRange)

将 C 列的内容复制到 G 列，效果如下图。

清空内容

clearContent()

在使用前需要先获取一个范围，然后会清空指定范围的内容。代码示例：

SpreadsheetApp.getActiveSheet().getRange('C:C').clearContent()

运行后会清理 C 列的内容。