javascript - 发送到 Google Apps 脚本的 Google 电子表格对象包装器中是否存在错误？

Question

附件是Test Sheet显示结果和预期结果。测试表具有运行该表所需的所有功能。

主函数应该返回从开始日期生成的一系列日期。每个日期应比前一个日期早三个月。

该测试使用该函数的两个版本，一种对日期对象使用 UTC 日期方法，另一种对日期对象使用普通日期方法。

“工作簿”中名为季度的工作表包含结果。图纸处理测试依赖于这些命名范围:StartDateQ、StartDateWeird。

任何想要解决此需求的人只需查看名为 Quarter 的工作表、包含函数的脚本页面，并具备 Google Apps 脚本和 Google Spreadsheet API 的应用知识。

问题

返回的日期数组与预期不符。在某些情况下，日期看起来正确，但某些日期包含不需要的时间数据，只能通过选择单元格才能看到。在某些情况下，日期不正确，相差一天。

为什么这是一个问题？

在实际的电子表格中，依赖于日期匹配的公式会失败，因为某些可视日期具有关联的实际时间数据。由于时间数据不匹配，即使从视觉上看，日期看起来相同，匹配也会失败。匹配失败会破坏工作表。

算法

1. 如果至少有一个要处理的开始日期，请使用 countAge() 获取生成日期的季度数。
2. 使用电子表格发送的开始日期初始化日期对象。
3. 创建一个空数组来保存返回电子表格的日期。
4. 对于季度计数，一次循环计数。
5. 将最新日期插入数组。
6. 将日期移至下一个季度，直到没有更多季度可以生成日期。
7. 将结果返回到电子表格

正在使用的函数(内部 API)

is(obj, type)//比较对象是否是正确的类型

countAge(dateString,dateString2)//计算日期之间的年数，即年龄

测试版本

quartersUTC(startDate,endDate)//从两个日期获取季度日期的自定义函数 - UTC 版本

quartersPlain(startDate,endDate)//从两个日期获取季度日期的自定义函数 - 普通版本

评论

因为两个测试函数都不依赖于“日期数学”，而是依赖于日期 setter ，例如，

不是这个:


d = 新日期();
d.setMonth(d.getMonth()) + 3;


但是这个:
if (latestDate.getMonth() == 0) {
最新日期.setMonth(3,1)
}


编程逻辑未能产生预期结果的原因似乎并不明显。

功能

这是普通版本。 UTC版本使用.setUTCmonth()

function quartersPlain(startDate,endDate)  {

// Check if there is a date to process, if not, exit.

  if (!is(startDate,"Date")) {
      return "Missing date";
  }


// Let's get the number of quarters  


  /* If there isn't an end date, we want the tally from the start date to now, aka the true age
     otherwise, we want want the tally between two dates.
  */
  var tally = 0; 
  if (!is(endDate,"Date")) {
    tally = (countAge(startDate) * 4) + 3
  } 
  else {

    if (new Date(endDate) > new Date(startDate)) {
      tally = (countAge(startDate,endDate) * 4)
    }
    else {
      tally = (countAge(endDate,startDate) * 4)
      startDate = endDate
    }
  }
  // testing ...
  // return tally



/* 
1. Initialize date object with start date sent from spreadsheet.
2. Make an empty array to hold dates to return to the spreadsheet.
3. For the tally of quarters, loop through one count at a time.
4. Insert the latest date to the array.
5. Move the date along to the next quarter.
*/

  // it's a logical fail needing to assign the date twice, kludgy 
  var latestDate = new Date(startDate);

  /* testing ...
  latestDate.setFullYear(latestDate.getUTCFullYear());
  latestDate.setUTCMonth(latestDate.getUTCMonth());
  latestDate.setDate(latestDate.getUTCDate());  
  */

  var dates = [ ]; 

  for (var loop = 0; loop < tally; loop++) {

    dates.push(new Date(latestDate));


    if (latestDate.getMonth() == 0) {
        latestDate.setMonth(3,1)
    }
    else if (latestDate.getMonth() == 1) {
        latestDate.setMonth(4,1)
    }
    else if (latestDate.getMonth() == 2) {
        latestDate.setMonth(5,1)
    }    
    else if (latestDate.getMonth() == 3) {
        latestDate.setMonth(6,1)
    }    
    else if (latestDate.getMonth() == 4) {
        latestDate.setMonth(7,1)
    }    
    else if (latestDate.getMonth() == 5) {
        latestDate.setMonth(8,1)
    }    
    else if (latestDate.getMonth() == 6) {
        latestDate.setMonth(9,1)
    }    
    else if (latestDate.getMonth() == 7) {
        latestDate.setMonth(10,1)
    }    
    else if (latestDate.getMonth() == 8) {
        latestDate.setMonth(11,1)
    }    
    else if (latestDate.getMonth() == 9) {
        latestDate.setMonth(0,1)
        latestDate.setFullYear(latestDate.getFullYear() + 1)
    }    
    else if (latestDate.getMonth() == 10) {
        latestDate.setMonth(1,1)
        latestDate.setFullYear(latestDate.getFullYear() + 1)
    } 
    else if (latestDate.getMonth() == 11) {
        latestDate.setMonth(2,1)
        latestDate.setFullYear(latestDate.getFullYear() + 1)
    }           

  }

   return dates;

}

`

Answer 1

简短的回答是这是由于夏令时所致。 :-)

在使用夏令时的时区，夏季季度的开始时间比未实行夏令时的日期早一小时。

例如，在我的时区 (AEST) [澳大利亚 = GMT+10/GMT+11 夏令时]，当我查看您的“起始季度”日期 1-APR-1947(自 1/1/以来 17258 天) 900)它在脚本调试器中将其报告为:

Tue Apr 01 1947 18:00:00 GMT+1000 (AEST)

(顺便说一句，这表明您本地的时区是 GMT-8 或美国西海岸，是吗？)

但是，如果我将其指向夏令时期间的某个日期(例如内部 1/1/1960 - 21916)，则其报告如下:

1960 年 1 月 1 日星期五 19:00:00 GMT+1100 (AEDT)

这意味着，当您使用 .setMonth() 或 .setUTCMonth() 在函数中计算新日期时，这些日期是“聪明的”，并考虑了夏令时。所以有时在结果集中您会得到 . 04167 额外一天(0.04167 x 86400 秒 = 3600 秒或 1 小时).. 通过将日期列的格式调整为“日期时间”可以轻松查看

解决这个问题的简单方法是在真实的电子表格中使用 =INT() 来报告 DATE 组件，而无需任何时间.. 毕竟，这就是您真正需要的看来对这里很感兴趣。

或者，除了 .setMonth() 调用之外，您还可以在脚本函数中使用 .setHours(0)。

我无法在您的示例数据中看到任何“日期相差 1 天”，但我可以通过使用 UTC 时间来导致类似的结果，然后当它们在本地时区中显示时，我可以看到例如 12/31/1949 23:00:00.. 因为在英国冬季期间，澳大利亚正处于夏季并且实行夏令时，反之亦然，在英国夏季/澳大利亚冬季，以及在两者之间( Spring 和秋季)都没有夏令时时，季度开始日期没有时间成分...产生一些有趣的结果:


1950年10月1日 0:00:00
1950年12月31日 23:00:00
1951 年 4 月 1 日 0:00:00
1951 年 7 月 1 日 1:00:00
1951 年 10 月 1 日 0:00:00

在您的数据中，您还会注意到，2007 年夏令时稍微延长时，1 月/4 月无时间和 7 月/10 月 +1 的模式发生了变化。其他有趣的(明显的)异常现象是由于他们过去使用夏令时的方式造成的。

顺便说一句，如果你想让你的原始代码更紧凑，你可以这样做:

for (var loop = 0; loop < tally; loop++) {
    dates.push(new Date(latestDate));

    var nextMonth = (latestDate.getMonth() + 3) % 12;   // mod 12 
    latestDate.setMonth(nextMonth,1);
    if (nextMonth < 3) {
        latestDate.setFullYear(latestDate.getFullYear() + 1)
    }
 }

哦，最后一件事，我建议您将问题的标题更改为“在 Google 表格/脚本中使用 .setMonth() 或 .setUTCMonth() 函数得出的意外时间结果”，因为这样可以更好地描述海事组织的问题。

干杯。