将 Google Sheets 中的日期格式化到 Webapp

本文旨在解决从 Google Sheets 中提取的日期数据在 Webapp 中显示格式不正确的问题。通过 Utilities.formatDate 函数或 getDisplayValue 方法，可以轻松地将日期格式化为所需的 "dd MMMM yyyy" 格式。此外，还介绍了使用 getValues 方法批量获取数据以提高脚本效率的最佳实践。

格式化 Google Sheets 日期到 Webapp 的两种方法

在使用 Google Apps Script 构建 Webapp 时，从 Google Sheets 获取的日期数据可能不会以你期望的格式显示。例如，你可能希望日期显示为 "dd MMMM yyyy"，但默认情况下，它可能显示为其他格式。以下介绍两种常用的方法来解决这个问题：

1. 使用 Utilities.formatDate 函数

Utilities.formatDate 函数可以将日期对象格式化为字符串，允许你指定所需的日期格式。

示例代码：

智谱AI输入法

智谱AI推出的AI语音输入法

下载

function submitDT(obj){
  var ss = SpreadsheetApp.openById("google sheet url");
  var sheet = ss.getSheetByName("mysheet");
  var  flag  =  1 ;
  var lr = sheet.getLastRow();
      for(var i = 1;i <= lr;i++){
  var vid = sheet.getRange(i, 2).getValue();
      if(vid ==obj){
      flag = 0;
  var b1 = sheet.getRange(i, 1).getValue();      
  // 格式化日期
  var b3 = sheet.getRange(i, 3).getValue();
  if (b3 instanceof Date) {
    b3 = Utilities.formatDate(b3, Session.getScriptTimeZone(), "dd MMMM yyyy");
  }
  var b4 = sheet.getRange(i, 4).getValue();
  var b5 = sheet.getRange(i, 5).getValue();
  var b6 = sheet.getRange(i, 6).getValue();
  var b7 = sheet.getRange(i, 7).getValue();
  // 格式化日期
  var b8 = sheet.getRange(i, 8).getValue();
  if (b8 instanceof Date) {
    b8 = Utilities.formatDate(b8, Session.getScriptTimeZone(), "dd MMMM yyyy");
  }

  var data ="
Transaction Information.
Tracking No.:
"
+obj+"
Transaction Title
"+b1+"
Date Accepted by Focal:
"+b3+"
Name of Establishment:
"+b4+"
Address:
"+b5+"
Status:
"+b6+"
Claimed by:
"+b7+"
Date Claimed:
"+b8+"";
  return data;
    }
   }
     if(flag==1){
  var data ="Transaction not found. For other concerns, please contact us at **********";
      return data;
    } 
    };
}

代码解释：

• Utilities.formatDate(date, timeZone, format): 这个函数接受三个参数：
  • date: 要格式化的日期对象。
  • timeZone: 时区字符串。 Session.getScriptTimeZone() 返回脚本的时区。
  • format: 日期格式字符串。 "dd MMMM yyyy" 表示日期格式为 "日 月 年"，其中 "dd" 是两位数的日，"MMMM" 是完整的月份名称，"yyyy" 是四位数的年份。
• if (b3 instanceof Date): 确保 b3 是一个 Date 对象，然后再进行格式化。

注意事项：

• 确保你的脚本具有正确的时区设置，以便日期格式化正确。
• Utilities.formatDate 函数返回的是字符串，因此你需要在使用它之前确保变量是 Date 对象。

2. 使用 getDisplayValue 方法

getDisplayValue 方法返回单元格中显示的字符串值，而不是实际的日期对象。如果 Google Sheets 中显示的日期格式与你想要的格式相同，则可以使用此方法。

示例代码：

function submitDT(obj){
  var ss = SpreadsheetApp.openById("google sheet url");
  var sheet = ss.getSheetByName("mysheet");
  var  flag  =  1 ;
  var lr = sheet.getLastRow();
      for(var i = 1;i <= lr;i++){
  var vid = sheet.getRange(i, 2).getValue();
      if(vid ==obj){
      flag = 0;
  var b1 = sheet.getRange(i, 1).getValue();      
  // 获取显示值
  var b3 = sheet.getRange(i, 3).getDisplayValue();
  var b4 = sheet.getRange(i, 4).getValue();
  var b5 = sheet.getRange(i, 5).getValue();
  var b6 = sheet.getRange(i, 6).getValue();
  var b7 = sheet.getRange(i, 7).getValue();
  // 获取显示值
  var b8 = sheet.getRange(i, 8).getDisplayValue();


  var data ="
Transaction Information.
Tracking No.:
"
+obj+"
Transaction Title
"+b1+"
Date Accepted by Focal:
"+b3+"
Name of Establishment:
"+b4+"
Address:
"+b5+"
Status:
"+b6+"
Claimed by:
"+b7+"
Date Claimed:
"+b8+"";
  return data;
    }
   }
     if(flag==1){
  var data ="Transaction not found. For other concerns, please contact us at **********";
      return data;
    } 
    };
}

代码解释：

• sheet.getRange(i, 3).getDisplayValue(): 获取单元格 (i, 3) 中显示的字符串值。

注意事项：

• getDisplayValue 方法返回的是字符串，因此你不需要进行额外的格式化。
• 如果 Google Sheets 中显示的日期格式不正确，则此方法将无法解决问题。

提高脚本效率：使用 getValues 批量获取数据

为了提高脚本的效率，建议使用 getValues 方法批量获取数据，而不是一次获取一个单元格的值。

示例代码：

function submitDT(obj){
  var ss = SpreadsheetApp.openById("google sheet url");
  var sheet = ss.getSheetByName("mysheet");
  var lr = sheet.getLastRow();
  // 获取所有数据
  var dataRange = sheet.getRange(1, 1, lr, 8);
  var data = dataRange.getValues();

  for(var i = 0; i < lr; i++){
    var vid = data[i][1]; // Column B (index 1)
    if(vid == obj){
      var b1 = data[i][0]; // Column A (index 0)
      var b3 = data[i][2]; // Column C (index 2)
      if (b3 instanceof Date) {
        b3 = Utilities.formatDate(b3, Session.getScriptTimeZone(), "dd MMMM yyyy");
      }
      var b4 = data[i][3]; // Column D (index 3)
      var b5 = data[i][4]; // Column E (index 4)
      var b6 = data[i][5]; // Column F (index 5)
      var b7 = data[i][6]; // Column G (index 6)
      var b8 = data[i][7]; // Column H (index 7)
      if (b8 instanceof Date) {
        b8 = Utilities.formatDate(b8, Session.getScriptTimeZone(), "dd MMMM yyyy");
      }

      var dataOutput = "
Transaction Information.
Tracking No.:
"
        + obj + "
Transaction Title
" + b1 + "
Date Accepted by Focal:
" + b3 + "
Name of Establishment:
" + b4 + "
Address:
" + b5 + "
Status:
" + b6 + "
Claimed by:
" + b7 + "
Date Claimed:
" + b8 + "";
      return dataOutput;
    }
  }

  var dataOutput = "Transaction not found. For other concerns, please contact us at **********";
  return dataOutput;
}

代码解释：

• sheet.getRange(1, 1, lr, 8).getValues(): 获取从第一行第一列开始，到最后一行第八列的所有数据，并将数据存储在一个二维数组中。
• data[i][1] 访问第 i 行第二列的数据。

总结：

通过使用 Utilities.formatDate 函数或 getDisplayValue 方法，你可以轻松地将 Google Sheets 中的日期格式化为 Webapp 中所需的格式。此外，使用 getValues 方法批量获取数据可以提高脚本的效率。选择哪种方法取决于你的具体需求和 Google Sheets 中显示的日期格式。建议优先使用 Utilities.formatDate 函数，因为它提供了更大的灵活性和控制力。