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。