如何在Apps Script中将日期年份转为字符串并定位对应Google Sheet工作表

我有一个Google Sheet文件，每个年份对应一个以YYYY格式命名的工作表（例如2023、2024）。我希望根据输入的日期提取年份，然后定位到对应年份的工作表。

我已通过以下代码将日期转换为年份格式：

var checkInYear = Utilities.formatDate(new Date(guestCInDate),'GMT','yyyy');

但执行以下代码时：

var hterCalendar = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(checkInYear).getActiveRange().getValue();

程序并未定位到对应年份的工作表，而是跳转到文件中的第一个工作表。我怀疑是因为checkInYear是日期类型变量，而工作表名称是字符串，导致无法匹配。

我曾尝试以下代码转换年份：

var checkInYear = guestCInDate.Substring(1,4);

但出现错误：

TypeError: guestCInDate.Substring is not a function

1. 关于Utilities.formatDate的返回值 #

Utilities.formatDate本身返回的就是字符串类型，所以你遇到的工作表匹配问题和类型无关，核心原因是getSheetByName(checkInYear)没找到对应工作表，后续调用getActiveRange()会默认使用当前活跃的工作表（通常是第一个）。

2. 为什么Substring报错？ #

guestCInDate是Date类型对象，JS中Date对象没有Substring方法（注意JS方法是小写开头的substring，但即使改成小写也不能直接用在Date对象上），字符串截取方法只能用于字符串类型。

3. 修正后的代码步骤 #

• 先确保guestCInDate是有效的Date对象（如果是从单元格读取的，可能是日期值或字符串，需要先转换）
• 提取年份后先验证值是否正确（避免格式或时区问题）
• 增加工作表存在性判断，避免空指针错误

示例代码：

// 示例：从单元格读取日期（替换成你的实际获取方式）
var guestCInDate = SpreadsheetApp.getActiveSheet().getRange("A1").getValue();

// 转换为年份字符串
var checkInYear = Utilities.formatDate(new Date(guestCInDate), 'GMT', 'yyyy');

// 打印验证年份值，确认和工作表名称完全一致（无空格、格式错误）
Logger.log("提取的年份：" + checkInYear);

// 获取目标工作表
var targetSheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(checkInYear);

if (targetSheet) {
  // 注意：getActiveRange()是用户当前选中的范围，建议指定具体单元格，比如A1
  var hterCalendar = targetSheet.getRange("A1").getValue();
} else {
  Logger.log("错误：未找到名为「" + checkInYear + "」的工作表");
}

额外排查点 #

• 确认工作表名称是纯数字的YYYY格式（比如2023，没有额外空格或符号）
• 时区是否正确：如果GMT不符合你的需求，换成对应时区（比如Asia/Shanghai），避免年份计算错误

内容的提问来源于stack exchange，提问作者Hulu Tamu Eco Resort