JavaScript toLocaleTimeString() 方法

JavaScript 中的 Date.toLocaleTimeString() 方法用于根据特定于区域设置的时间格式将 Date 对象转换为表示日期时间部分的字符串。

语法

以下是 JavaScript Date toLocaleTimeString() 方法的语法：

toLocaleTimeString(locales, options);

参数

此方法接受两个参数。下面描述了这些参数：

locales (可选) − 此参数可选，表示带有 BCP 47 语言标签的字符串或此类字符串的数组。它指定要使用的区域设置。如果未提供此参数或未定义，则使用 JavaScript 运行时的默认区域设置。
options (可选) − 一个可选参数，表示一个对象，其中包含自定义输出的属性。这些属性包括：
- timezone 指定要使用的时区。默认为运行时的默认时区。
- hour12 一个布尔值，指示是否使用 12 小时制 (true) 或 24 小时制 (false)。默认为运行时的默认设置。
- hour 一个字符串，其值例如 "numeric"、"2-digit" 或 undefined。
- minute 一个字符串，其值例如 "numeric"、"2-digit" 或 undefined。
- second 一个字符串，其值例如 "numeric"、"2-digit" 或 undefined。
- timeZoneName 一个字符串，其值例如 "short"、"long" 或 undefined。

返回值

此方法根据当前区域设置的约定返回日期对象的 time 部分作为字符串。

示例 1

以下示例使用 JavaScript Date toLocaleTimeString() 方法以用户的本地时区返回日期的时间部分：

<html>
<body>
<script>
   const date = new Date();
   const timeString = date.toLocaleTimeString();

   document.write(timeString);
</script>
</body>
</html>

输出

正如我们在输出中看到的，它返回了 Date 对象的时间部分。

示例 2

在此示例中，我们使用 "options" 参数来自定义输出。hour 和 minute 选项设置为以两位数字格式显示时间。

<html>
<body>
<script>
   const date = new Date();
   const options = { hour: '2-digit', minute: '2-digit' };
   const timeString = date.toLocaleTimeString(undefined, options);

   document.write(timeString);
</script>
</body>
</html>

输出

正如我们在输出中看到的，小时和分钟以两位数字格式显示。

示例 3

在此，hour12 选项设置为 false，这意味着时间将以 24 小时制 (0-23) 格式显示，而不是带有 AM/PM 的默认 12 小时制格式。

<html>
<body>
<script>
   const date = new Date();
   const options = { hour12: false };
   const timeString = date.toLocaleTimeString(undefined, options);

   document.write(timeString);
</script>
</body>
</html>

输出

如果我们执行程序，它将显示 24 小时制的时间以及 AM/PM。

打印页面