如何在Google App Scripts中格式化当前时间为11:56 AM格式？

嘿，我明白你在Google Apps Script里格式化时间时遇到的麻烦了——确实有时候内置方法的表现和普通JavaScript不太一样，尤其是toLocaleTimeString()在这里的问题。别担心，咱们有几种可靠的方法来实现你想要的11:56 AM格式：

方法1：使用Utilities.formatDate()（官方推荐） #

这是Google Apps Script专门提供的格式化工具，完全适配GAS环境，用法直接且稳定：

function formatTimeToAMPM() {
  const now = new Date();
  // 用Session.getScriptTimeZone()获取脚本默认时区，也可手动指定如"America/New_York"
  const formattedTime = Utilities.formatDate(now, Session.getScriptTimeZone(), "h:mm a");
  Logger.log(formattedTime); // 输出示例："11:56 AM"
}

几个关键说明：

• Utilities.formatDate()需要三个参数：Date对象、时区字符串、格式模板
• 格式模板中：h是12小时制小时（无前置零），mm是两位分钟，a会自动生成AM/PM标识（小写用aa，大写用AA，通常a就够用）
• 时区用Session.getScriptTimeZone()能保证和脚本默认时区一致，避免时间偏差

方法2：手动拼接时间字符串 #

如果想完全自定义格式逻辑，也可以手动提取时间组件来构建结果：

function manualFormatTime() {
  const now = new Date();
  let hours = now.getHours();
  const minutes = now.getMinutes().toString().padStart(2, '0');
  const ampm = hours >= 12 ? 'PM' : 'AM';
  
  // 转换为12小时制，处理0点为12 AM的情况
  hours = hours % 12;
  hours = hours ? hours : 12;
  
  const formattedTime = `${hours}:${minutes} ${ampm}`;
  Logger.log(formattedTime); // 输出示例："11:56 AM" 或 "1:05 PM"
}

要是想要带前置零的小时（比如09:30 AM），只需把hours改成hours.toString().padStart(2, '0')即可。

关于toLocaleTimeString()的小补充 #

其实GAS环境是支持toLocaleTimeString()的，但偶尔会因执行上下文或旧版运行时出现未定义的报错。如果想尝试让它工作，可以明确指定区域和配置选项：

function tryLocaleTimeString() {
  const now = new Date();
  const formattedTime = now.toLocaleTimeString('en-US', { 
    hour: 'numeric', 
    minute: '2-digit', 
    hour12: true 
  });
  Logger.log(formattedTime);
}

不过还是更推荐用Utilities.formatDate()，它在GAS里的兼容性和稳定性更有保障。

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