JavaScript Date toLocaleTimeString() 方法

JavaScript 中的 Date.toLocaleTimeString() 方法用于将 Date 对象转换为表示日期时间部分的字符串，并根据特定于语言环境的时间格式进行转换。

语法

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

toLocaleTimeString(locales, options);

参数

此方法接受两个参数。具体参数如下所述 -

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

返回值

此方法根据当前语言环境的约定，以字符串形式返回日期对象的时间部分。

示例 1

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

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

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

输出

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

示例 2

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

<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 格式。