JavaScript Date toLocaleString() 方法

JavaScript 中的 Date.toLocaleString() 方法用于将 Date 对象转换为字符串，该字符串以特定于区域设置的格式表示日期和时间，并基于当前区域设置。

语法

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

toLocaleString(locales, options);

参数

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

locales (可选) − 一个字符串或字符串数组，表示 BCP 47 语言标签，或此类字符串的数组。它指定一个或多个用于日期格式化的区域设置。如果 locales 参数未定义或为空数组，则使用运行时的默认区域设置。
options (可选) − 一个对象，允许您自定义格式。它可以具有诸如 weekday、year、month、day、hour、minute、second 等属性，具体取决于您是在格式化日期还是时间。

返回值

此方法返回 Date 对象作为字符串，使用区域设置。

示例 1

在下面的示例中，我们演示了 JavaScript Date toLocaleString() 方法的基本用法：

<html>
<body>
<script>
   const currentDate = new Date();
   const formattedDate = currentDate.toLocaleString();

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

输出

它返回一个 Date 对象作为字符串，使用区域设置。

示例 2

在这里，我们使用 toLocaleString() 方法以及特定的选项来根据英文（美国）区域设置格式化日期，以显示长星期几、年份、月份和日期。

<html>
<body>
<script>
   const currentDate = new Date();
   const options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };
   const formattedDate = currentDate.toLocaleString('en-US', options);

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

输出

正如我们在输出中看到的，它根据指定的格式显示日期。

示例 3

在此示例中，我们自定义时间格式以在 12 小时时钟中显示小时、分钟和秒，并为一位数的值使用前导零。

<html>
<body>
<script>
   const currentDate = new Date();
   const options = { hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: true };
   const formattedDate = currentDate.toLocaleString('en-US', options);

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

输出

正如我们在输出中看到的，它以 12 小时时钟格式显示日期。

打印页面