Skip to content

Date.prototype.toLocaleTimeString() 方法 ​

toLocaleTimeString() 方法按地区把一个 Date 写成文字。它用的是 Intl.DateTimeFormat 同一套,没给字段和样式时写的是只有时间。

语法 ​

toLocaleTimeString()
toLocaleTimeString(locales)
toLocaleTimeString(locales, options)

参数 ​

locales 可选

同 Intl.DateTimeFormat() 构造函数。

options 可选

同 Intl.DateTimeFormat() 构造函数。不接受 dateStyle。

返回值 ​

字符串。无效的日期不抛,返回 'Invalid Date'。

异常 ​

同 Intl.DateTimeFormat() 构造函数。

另外,options 里给了 dateStyle 时抛 TypeError: dateStyle is specified while formatting time is requested。

三个方法的默认写法 ​

方法没给字段和样式时en-US 的例子
toLocaleString()日期和时间11/15/2026, 3:05:09 PM
toLocaleDateString()只有日期11/15/2026
toLocaleTimeString()只有时间3:05:09 PM

示例 ​

js
const moment = new Date(Date.UTC(2026, 10, 15, 15, 5, 9));
console.log(moment.toLocaleTimeString('en-US', { timeZone: 'UTC' }));

结果:控制台输出 3:05:09 PM。这个输出未在模拟器验证;不带字段的这个方法在验收用例里和网页比对过,用的是别的时刻。

和 Web 的差别 ​

和 Intl.DateTimeFormat 的差别相同,见 Intl.DateTimeFormat。

参见 ​