Date.prototype.toTimeString()

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

toTimeString() 方法用于 Date 对象,返回一个表示该日期时间部分的字符串,该时间部分根据本地时区进行解释。

试一试

const event = new Date("August 19, 1975 23:15:30");

console.log(event.toTimeString());
// Expected output: "23:15:30 GMT+0200 (CEST)"
// Note: your timezone may vary

语法

js
toTimeString()

参数

无。

返回值

返回一个表示给定日期时间部分的字符串(格式请参阅描述)。如果日期 无效,则返回 "Invalid Date"

描述

Date 对象指的是一个特定的时间点。toTimeString() 方法根据本地时区解释该日期,并以英语格式化时间部分。它始终使用 HH:mm:ss GMT±xxxx (TZ) 格式,其中:

格式字符串 描述
HH 小时,两位数,不足两位时前面补零
mm 分钟,两位数,不足两位时前面补零
ss 秒,两位数,不足两位时前面补零
±xxxx 本地时区的偏移量 — 小时两位数,分钟两位数(例如:-0500+0800
TZ 时区的名称(例如:PDTPST

例如:"04:42:04 GMT+0000 (Coordinated Universal Time)"。

  • 如果您只想获取日期部分,请使用 toDateString()
  • 如果您想获取日期和时间,请使用 toString()
  • 如果希望日期根据 UTC 而非本地时区进行解析,请使用 toUTCString()
  • 如果您想以更友好的格式(例如,本地化)显示日期,请使用 toLocaleTimeString()

示例

使用 toTimeString()

js
const d = new Date(0);

console.log(d.toString()); // "Thu Jan 01 1970 00:00:00 GMT+0000 (Coordinated Universal Time)"
console.log(d.toTimeString()); // "00:00:00 GMT+0000 (Coordinated Universal Time)"

规范

规范
ECMAScript® 2026 语言规范
# sec-date.prototype.totimestring

浏览器兼容性

另见