使用 GAS 从电子表格读取时间值或将时间值写入电子表格

我真的以为我开始理解这是如何工作的，直到我尝试为这个问题提炼一个测试用例，然后又完全困惑了。

使用谷歌电子表格，您可以编写如下自定义函数：

function dateToSeconds(date) {
  var hours = date.getHours();
  var minutes = date.getMinutes();
  var seconds = date.getSeconds();
  return (hours*3600) + (minutes*60) + seconds;
}

并通过执行以下操作在单元格中调用它：

=dateToSeconds(A1)

它正如你所期望的那样。但是，如果你这样称呼它：

function test() {
    var sheet = SpreadsheetApp.getActiveSheet();

    sheet.getRange("A2").setValue(dateToSeconds(sheet.getRange("A1").getValue()));
}

存在 25m 21s 的差异。有没有搞错？

另外，如果您想从脚本返回日期对象，以便将其格式化为时间，您可以执行以下操作：

function newTime(hours, minutes, seconds) {
    // 1899-12-30 is the epoch for time values, it seems
    // http://stackoverflow.com/questions/4051239/how-to-merge-date-and-time-as-a-datetime-in-google-apps-spreadsheet-script
   return new Date(1899, 11, 30, hours, minutes, seconds, 0);
 }

并通过执行以下操作来调用它：

=newTime(A1, A2, A3)

而且效果很好。如果你这样做：

function test() {
    var sheet = SpreadsheetApp.getActiveSheet();
    var values = sheet.getRange("A1:C3").getValues();
    sheet.getRange("D3").setValue(newTime(values[0], values[1], values[2]));
}

然后（给定输入 11:00:00）它会被格式化为日期，如下所示：

1970年1月1日 01:00:00

看起来它被解释为更传统的 1970 纪元之后的一个小时？我认为我之前看到的行为与上面的 25m 21s 偏移有点对称，我会看到：

10:34:39

我的测试用例是here https://docs.google.com/spreadsheet/ccc?key=0Ajjz7TV774F2dEZQbXRFQlpKRFNqTWVlWUt2UnE5cWc

=dateToSeconds() 与 test() 函数的行为似乎确实有些奇怪。看起来有一个错误导致了两者之间的时间差异。请在中提出错误问题跟踪器 http://code.google.com/p/google-apps-script-issues/issues/list.

不过，我可以通过在单元格上使用数字格式来实现此目的。看看我的电子表格的修改副本 https://docs.google.com/spreadsheet/ccc?key=0AoUJGlizbtP3dHo2cm1LalpnekJFblc2Y1RjR0ZvZ0E。在单元格 A2 中，我输入“29/04/2012 11:00:00”，然后设置“格式”>“数字”>“15:59:00 时间”。您还可以使用以下方式以编程方式执行此操作Range.setNumberFormat https://developers.google.com/apps-script/class_range#setNumberFormat(“时:分:秒”);这会导致单元格 A2 显示 11:00:00。

然后，我修改了您的测试函数以具有以下代码：

function test() {
  var sheet = SpreadsheetApp.getActiveSheet();

  sheet.getRange("E2").setValue(dateToSeconds(sheet.getRange("A2").getValue()));
  Logger.log(sheet.getRange("A2").getValue());
  Logger.log(sheet.getRange("A2").getNumberFormat());

  var values = sheet.getRange("A4:C4").getValues();
  Logger.log(values[0][0] + " " + values[0][1] + " " + values[0][2]);
  sheet.getRange("E4").setValue(newTime2(values[0][0], values[0][1], values[0][2])).setNumberFormat("HH:mm:ss");
}

我使用以下代码创建了 newTime2，而不是 newTime 函数：

function newTime2(hours, minutes, seconds) {
  var date = new Date();
  date.setHours(hours);
  date.setMinutes(minutes);
  date.setSeconds(seconds);
  Logger.log(date);
  return date;
}

我希望这有帮助。