HOWTO · JavaScript

在 JavaScript 中以 12 小时 AM/PM 格式显示日期时间

本教程展示了如何以 12 小时 AM/PM 格式显示 JavaScript 日期时间。使用不同的方法,例如创建我们自己的函数,Date.prototype.toLocaleString,Date.prototype.toLocaleTimeString,和 moment.js 方法来实现这一点。

本页内容

JavaScript 的 Date 保存一个时间值;它没有统一的显示格式。方法会将该值转换为文本,而结果取决于使用本地时间、地区设置还是自定义格式规则。本指南介绍如何生成包含小时、分钟、秒和 AM/PM 标记的 12 小时制时间,可以单独显示,也可以与日期一起显示。

使用原生 JavaScript 函数格式化日期

一个简单的辅助函数无需依赖库,就能让你精确控制标点和大小写。getHours()、getMinutes() 和 getSeconds() 会根据机器的本地时区读取日期。取余运算可将小时转换为 12 小时制;由于午夜和中午取余后都会得到 0,因此要把这个值转换为 12。分钟和秒不足两位时应补零,使其始终占两位数字。

运行以下示例:

本节中的代码以及显示的标签或输出仍为英文。

function formatAmPm(date) {
  const hour24 = date.getHours();
  const period = hour24 < 12 ? 'AM' : 'PM';
  const hour12 = hour24 % 12 || 12;
  const twoDigits = (value) => String(value).padStart(2, '0');

  return `${twoDigits(hour12)}:${twoDigits(date.getMinutes())}:${twoDigits(date.getSeconds())} ${period}`;
}

const sample = new Date(2024, 0, 1, 0, 5, 9);
console.log(formatAmPm(sample));

数值形式的 Date 构造函数使用从零开始的月份编号,因此 0 表示一月。此示例会构造 2024 年 1 月 1 日本地时间的午夜。辅助函数也能正确处理正午(12:00:00 PM)和下午时段:它会调整标记,并将小时转换到 1 至 12 的范围。如果需要按 UTC 格式化,请改用 getUTC... 方法;不要混用本地时间获取方法和 UTC 获取方法。

Date.prototype.toLocaleString:本地化日期和时间

如果结果需要同时包含日期和时间,并遵循某个地区的惯例,请使用 Date.prototype.toLocaleString。hour、minute 和 second 选项用于指定各时间组成部分,hour12: true 则请求使用 12 小时制。地区设置可能会影响顺序、标点、空格和 AM/PM 标记,因此不要假设不同环境中的完整字符串都具有相同的固定写法。

本节中的代码以及显示的标签或输出仍为英文。

const date = new Date(2024, 0, 1, 13, 5, 9);
const formatted = date.toLocaleString('en-US', {
  year: 'numeric',
  month: 'numeric',
  day: 'numeric',
  hour: 'numeric',
  minute: '2-digit',
  second: '2-digit',
  hour12: true,
});
console.log(formatted);

这里的选项会同时请求日期和时间。在支持的情况下,minute 和 second 会以两位数字显示,hour12 则选择 12 小时制。最终的排列方式和标记由地区数据决定;显示返回的字符串即可,不要假设每个浏览器都会插入相同的逗号或空格。

Date.prototype.toLocaleTimeString:仅显示本地化时间

不需要日期时,请使用 Date.prototype.toLocaleTimeString。它接受与前一个示例相同的地区和时间选项,但只格式化时间部分。因此,当 toLocaleString 包含日期时,两者并不等效。

本节中的代码以及显示的标签或输出仍为英文。

const date = new Date(2024, 0, 1, 13, 5, 9);
const formatted = date.toLocaleTimeString('en-US', {
  hour: 'numeric',
  minute: '2-digit',
  second: '2-digit',
  hour12: true,
});
console.log(formatted);

明确指定选项可以清楚表达需要哪些时间组成部分,但地区实现仍会决定标点和 AM/PM 标记的具体形式。如果产品要求固定的字符串格式,请使用自定义辅助函数,而不要依赖地区化呈现。

使用 Moment.js 格式化日期

如果项目已经引入该库,可以使用 Moment.js 格式化日期。它是一个独立依赖:以下表达式假设应用已经导入或加载了 moment。格式标记 hh、mm 和 ss 分别请求两位数的 12 小时制小时、分钟和秒;A 会输出大写的 AM/PM 标记。例如,可以使用 moment(date).format('hh:mm:ss A')。如果普通 JavaScript 文件尚未加载 Moment.js,请勿将此表达式直接复制到其中。对于新项目,内置的 Intl 方法或简单的原生辅助函数都可以避免增加此依赖。

选择合适的方法并验证边界情况

如果输出必须遵循固定格式,例如 hh:mm:ss AM,请选择原生辅助函数。若只需要本地化时间,请选择 Date.prototype.toLocaleTimeString;若日期和时间需要一起显示,请选择 Date.prototype.toLocaleString。如果应用已经使用 Moment.js,且其基于格式标记的方式符合项目需求,也可以选择它。这些方法不能保证输出完全一致:原生辅助函数定义特定的布局,地区方法会适应地区数据,而 Moment.js 则遵循其格式标记。

调整格式化函数时,请检查几个有代表性的本地时间:午夜应显示为 12 和 AM,中午应保留为 12 和 PM,不足两位的分钟和秒应补零。还应检查一个下午时段,确认将 24 小时制小时减去十二后,显示结果符合预期。这些检查有助于发现常见错误,例如把午夜或中午显示为 0,或者承诺输出 HH:MM:SS 却在示例中漏掉秒。如果输入代表来自其他时区的时间戳,请先确定界面应显示查看者的本地时间还是 UTC,再进行格式化。