JavaScript Date toLocaleTimeString（）方法

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

语法

以下是 JavaScript Date.toLocaleTimeString（） 方法的语法 -


 toLocaleTimeString(locales, options);

参数

此方法接受两个参数。相同的描述如下 -

locales （可选） - 这是一个可选参数，表示带有 BCP 47 语言标签的字符串或此类字符串的数组。它指定要使用的一个或多个 locale。如果未提供或未定义此参数，则使用 JavaScript 运行时的默认区域设置。
options （可选） − 一个可选参数，表示具有自定义输出的属性的对象。这些属性包括 -
- timezone 指定要使用的时区。默认值是运行时的默认时区。
- hour12 一个布尔值，指示是使用 12 小时时间格式（true）还是 24 小时时间格式（false）。Default 是运行时的默认设置。
- hour 类似于 “numeric”、“2-digit” 或 undefined 的字符串。
- minute 类似于 “numeric”、“2-digit” 或 undefined 的字符串。
- second 类似于 “numeric”、“2-digit” 或 undefined 的字符串。
- timeZoneName 类似于 “short”、“long” 或 undefined 的字符串。

返回值

此方法根据当前区域设置的约定将 date 对象的 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）显示，而不是默认的 12 小时格式 AM/PM。


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

本页

JavaScript Date toLocaleTimeString（） 方法

语法

参数

返回值

示例 1

示例 2

示例 3

JavaScript Date toLocaleTimeString（）方法