Google 应用脚本 getSheetByName - JavaScript

简介

Google 应用脚本是一种基于 JavaScript 的云端开发工具，可用于创建和部署各种 Google 应用，如谷歌表格、谷歌文档等。getSheetByName() 是谷歌表格方法之一，用于按名称获取工作表对象，以便在代码中对其进行引用。

使用方法

以下是使用 getSheetByName() 获取工作表对象的基本语法：

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);

其中：

• SpreadsheetApp.getActiveSpreadsheet() 获取当前活动的谷歌表格。
• getSheetByName(sheetName) 按名称获取工作表对象。

例：

var sheetName = "Sheet1";
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);

在这个例子中，我们将 Sheet1 的名称赋值给变量 sheetName，然后使用 getSheetByName() 方法获取该工作表的对象并将其赋值给变量 sheet。现在，我们可以在代码中执行与该工作表相关的操作。

返回值

getSheetByName() 方法返回的是工作表对象。如需访问工作表的值或元素，请参考以下示例：

• 获取工作表中单元格的值：

var value = sheet.getRange("A1").getValue();

• 在工作表中写入值：

sheet.getRange("A1").setValue("Hello World!");

• 设置单元格格式：

sheet.getRange("A1").setBorder(false, false, true, false, false, false, "black", SpreadsheetApp.BorderStyle.SOLID_MEDIUM);

• 在工作表中插入行：

sheet.insertRowAfter(1);

更多有关 Google 应用脚本的信息，请访问官方文档。