
在google apps script开发web应用并从google表格中拉取数据时,日期格式经常是开发者遇到的一个常见挑战。当使用range.getvalue()方法获取单元格内容时,日期通常会以默认的date对象形式返回,这在web应用中直接显示时可能不符合我们期望的“dd mmmm yyyy”等特定格式。本教程将详细介绍如何有效地处理这些日期格式问题,并提供代码示例。
在您的示例代码中,b3和b8变量通过sheet.getRange(i, 3).getValue()和sheet.getRange(i, 8).getValue()获取日期。虽然Google表格内部可能已经设置了显示格式,但getValue()方法返回的是一个JavaScript Date对象,当将其直接拼接成字符串时,会使用其默认的字符串表示形式,这通常不是用户友好的“dd MMMM yyyy”格式。
例如,如果Google表格中显示的是“2023年10月26日”,getValue()可能返回一个类似Thu Oct 26 2023 00:00:00 GMT+0800 (China Standard Time)的Date对象。直接将其插入HTML字符串会导致显示不佳。
Google Apps Script提供了Utilities.formatDate()方法,允许您将Date对象格式化为任意字符串格式。这是处理日期格式化最灵活和推荐的方法。
Utilities.formatDate(date, timeZone, format)方法接受三个参数:
示例代码:
假设您想将b3和b8格式化为“dd MMMM yyyy”:
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_date = sheet.getRange(i, 3).getValue(); // 获取原始Date对象
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_date = sheet.getRange(i, 8).getValue(); // 获取原始Date对象
// 使用Utilities.formatDate进行格式化
var b3 = Utilities.formatDate(b3_date, Session.getScriptTimeZone(), "dd MMMM yyyy");
var b8 = Utilities.formatDate(b8_date, Session.getScriptTimeZone(), "dd MMMM yyyy");
var data = "<center><table><tr><th colspan=2>Transaction Information.</th></tr><tr><td>Tracking No.:</td><td>"
+ obj + "</td></tr><tr><td>Transaction Title</td><td>" + b1 + "</td></tr><tr><td>Date Accepted by Focal:</td><td>" + b3 + "</td></tr><tr><td>Name of Establishment:</td><td>" + b4 + "</td></tr><tr><td>Address:</td><td>" + b5 + "</td></tr><tr><td>Status:</td><td>" + b6 + "</td></tr><tr><td>Claimed by:</td><td>" + b7 + "</td></tr><tr><td>Date Claimed:</td><td>" + b8 + "</td></tr></table></center>";
return data;
}
}
if(flag == 1){
var data = "Transaction not found. For other concerns, please contact us at **********";
return data;
}
}常用日期格式化字符串:
如果您希望Web应用中显示的日期格式与Google表格中单元格的显示格式完全一致,那么Range.getDisplayValue()是一个更简洁的选择。此方法直接返回单元格中可见的字符串值,而不是Date对象。
示例代码:
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 = "<center><table><tr><th colspan=2>Transaction Information.</th></tr><tr><td>Tracking No.:</td><td>"
+ obj + "</td></tr><tr><td>Transaction Title</td><td>" + b1 + "</td></tr><tr><td>Date Accepted by Focal:</td><td>" + b3 + "</td></tr><tr><td>Name of Establishment:</td><td>" + b4 + "</td></tr><tr><td>Address:</td><td>" + b5 + "</td></tr><tr><td>Status:</td><td>" + b6 + "</td></tr><tr><td>Claimed by:</td><td>" + b7 + "</td></tr><tr><td>Date Claimed:</td><td>" + b8 + "</td></tr></table></center>";
return data;
}
}
if(flag == 1){
var data = "Transaction not found. For other concerns, please contact us at **********";
return data;
}
}选择建议:
在您的原始代码中,循环内多次调用sheet.getRange().getValue(),这会导致每次迭代都与Google表格服务进行一次通信。这种逐个单元格读取的方式效率低下,尤其是在处理大量数据时会显著降低脚本性能。
Google Apps Script的最佳实践是使用批量操作,例如Range.getValues()方法,一次性获取一个区域内的所有数据。getValues()会返回一个二维数组,其中每个内部数组代表一行数据。
优化后的代码示例:
function submitDT(obj){
var ss = SpreadsheetApp.openById("google sheet url"); // 请替换为您的Google Sheet ID
var sheet = ss.getSheetByName("mysheet");
var flag = 1;
var lr = sheet.getLastRow();
// 最佳实践:一次性获取所有相关数据
// 获取从第一行第一列到最后一行的第八列的所有数据
var allData = sheet.getRange(1, 1, lr, 8).getValues();
// 遍历allData数组,注意数组是0-indexed
for(var i = 0; i < allData.length; i++){
var row = allData[i]; // 当前行的数据数组
var vid = row[1]; // 第二列 (索引为1) 的值,对应原始b2
if(vid == obj){
flag = 0;
var b1 = row[0]; // 第一列 (索引为0)
var b3_date = row[2]; // 第三列 (索引为2),原始Date对象
var b4 = row[3]; // 第四列 (索引为3)
var b5 = row[4]; // 第五列 (索引为4)
var b6 = row[5]; // 第六列 (索引为5)
var b7 = row[6]; // 第七列 (索引为6)
var b8_date = row[7]; // 第八列 (索引为7),原始Date对象
// 检查b3_date和b8_date是否为有效的Date对象,
// 因为getValues()可能返回空单元格或非日期类型的值
var b3_formatted = (b3_date instanceof Date) ? Utilities.formatDate(b3_date, Session.getScriptTimeZone(), "dd MMMM yyyy") : b3_date;
var b8_formatted = (b8_date instanceof Date) ? Utilities.formatDate(b8_date, Session.getScriptTimeZone(), "dd MMMM yyyy") : b8_date;
var data = "<center><table><tr><th colspan=2>Transaction Information.</th></tr><tr><td>Tracking No.:</td><td>"
+ obj + "</td></tr><tr><td>Transaction Title</td><td>" + b1 + "</td></tr><tr><td>Date Accepted by Focal:</td><td>" + b3_formatted + "</td></tr><tr><td>Name of Establishment:</td><td>" + b4 + "</td></tr><tr><td>Address:</td><td>" + b5 + "</td></tr><tr><td>Status:</td><td>" + b6 + "</td></tr><tr><td>Claimed by:</td><td>" + b7 + "</td></tr><tr><td>Date Claimed:</td><td>" + b8_formatted + "</td></tr></table></center>";
return data;
}
}
if(flag == 1){
var data = "Transaction not found. For other concerns, please contact us at **********";
return data;
}
}注意事项:
通过本教程,您应该已经掌握了在Google Apps Script Web应用中处理Google表格日期格式的两种主要方法:
同时,为了提高脚本的运行效率和性能,强烈建议采用Range.getValues()进行批量数据读取,而不是在循环中逐个单元格地调用getValue()或getDisplayValue()。结合这些技术,您可以构建出既功能强大又高效的Google Apps Script Web应用。
以上就是Google Apps Script中Google表格日期格式化指南的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号