如何在Google Apps Script中实现基于转移时间的0至一周计时器？

一、修改现有代码，记录数据转移时间 #

先在你的saveTax函数中，完成数据复制后，在目标行的相邻列（这里默认是第4列，即D列）记录当前转移时间，后续倒计时将基于这个时间计算：

function saveTax() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var taxForm = ss.getSheetByName('Tax Form');

  var lastRow = taxForm.getLastRow();
  var targetRow = lastRow + 1;

  if (taxForm.getRange('C7').isBlank()){
    taxForm.getRange('C7').setBackground('#ff0000');
    throw new Error('Required Cell is Missing Info. '); 
  } else {
    // 复制B7数据到目标行第2列
    var valuesToCopy = taxForm.getRange('B7').getValues();
    taxForm.getRange(targetRow, 2, 1, valuesToCopy.length).setValues([valuesToCopy.flat()]);

    // 复制C7数据到目标行第3列
    valuesToCopy = taxForm.getRange('C7').getValues();
    taxForm.getRange(targetRow, 3, 1, valuesToCopy.length).setValues([valuesToCopy.flat()]);

    // 新增：记录数据转移的当前时间到目标行第4列（D列），并设置时间格式
    var transferTime = new Date();
    taxForm.getRange(targetRow, 4).setValue(transferTime).setNumberFormat("yyyy-MM-dd HH:mm:ss");

    taxForm.getRange('C7').setBackground('#ffffff');
  }
}

二、实现倒计时的两种方案 #

方案1：使用Sheet内置公式（无需额外脚本）

在目标行的第5列（E列）添加以下公式，它会自动计算从转移时间到一周后剩余的时间，超过一周后显示0：

=IF(D2<>"", MAX(0, (D2+7*24*60*60*1000)-NOW()), "")

• 说明：D2是转移时间所在单元格，可将单元格格式设置为[h]:mm:ss来显示小时:分钟:秒，或自定义格式显示天/时/分。
• 优势：无需额外脚本，Sheet会自动刷新计算。

方案2：使用脚本定期更新倒计时（自定义显示格式）

如果需要更灵活的显示（比如“剩余X天X小时X分”），可以创建倒计时更新函数并设置时间触发器定期运行：

1. 创建倒计时更新函数：

function updateCountdown() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var taxForm = ss.getSheetByName('Tax Form');
  var dataRange = taxForm.getDataRange();
  var values = dataRange.getValues();
  
  // 遍历所有行（从第2行开始，假设第1行是表头）
  for (var i = 1; i < values.length; i++) {
    var transferTime = values[i][3]; // 对应D列，数组索引从0开始
    if (transferTime instanceof Date) {
      var oneWeekLater = new Date(transferTime.getTime() + 7 * 24 * 60 * 60 * 1000);
      var now = new Date();
      var remainingMs = oneWeekLater - now;
      
      var countdownText = "";
      if (remainingMs > 0) {
        // 计算天、时、分
        var days = Math.floor(remainingMs / (1000 * 60 * 60 * 24));
        var hours = Math.floor((remainingMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
        var minutes = Math.floor((remainingMs % (1000 * 60 * 60)) / (1000 * 60));
        countdownText = `${days}天${hours}时${minutes}分`;
      } else {
        countdownText = "已到期";
      }
      
      // 将倒计时写入E列（第5列，数组索引4）
      taxForm.getRange(i+1, 5).setValue(countdownText);
    }
  }
}

2. 设置时间触发器：

• 打开脚本编辑器，点击左侧时钟图标（触发器）。
• 点击“添加触发器”，配置如下：
  • 选择函数：updateCountdown
  • 部署类型：基于时间的触发器
  • 时间间隔：比如“分钟计时器”，每5分钟运行一次（可按需调整）
• 保存触发器后，脚本会定期自动更新所有行的倒计时。

内容的提问来源于stack exchange，提问作者Narukami