JavaScript toLocaleDateString() 方法

在 JavaScript 中，Date.toLocaleDateString() 方法用于将日期对象转换为字符串，表示根据当前区域设置格式的日期部分。

toLocaleDateString() 方法根据特定于区域设置的约定和格式选项返回表示给定 Date 对象的日期部分的字符串。返回字符串的格式可能因区域设置和提供的选项而异。

语法

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

toLocaleDateString(locales, options);

参数

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

locales (可选) − 表示 BCP 47 语言标记的字符串或字符串数组，或此类字符串的数组。它指定一个或多个用于日期格式化的区域设置。如果 locales 参数未定义或为空数组，则使用运行时的默认区域设置。
options (可选) − 包含用于自定义日期格式的属性的对象。此对象可以具有诸如“weekday”、“year”、“month”、“day”等属性。每个属性可以具有诸如“numeric”、“2-digit”、“long”、“short”或“narrow”的值，以自定义日期该部分的显示方式。

返回值

此方法仅返回日期对象作为字符串的日期（而不是时间），使用区域设置约定。

示例 1

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

<html>
<body>
<script>
   const today = new Date();
   const dateString = today.toLocaleDateString();

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

输出

以上程序使用区域设置约定返回日期对象作为字符串的日期。

示例 2

在此示例中，我们使用“options”参数指定长格式日期格式，包括星期几、月份、日期和年份。我们还将区域设置设置为“en-US”：

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

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

输出

正如我们在输出中看到的，它显示了长格式的日期格式。

示例 3

在这里，我们通过将指定的区域设置字符串作为第一个参数传递给 toLocaleDateString() 方法来使用不同的区域设置：

<html>
<body>
<script>
   const today = new Date();
   const options = { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' };

   document.write(today.toLocaleDateString('en-US', options), "
");
   document.write(today.toLocaleDateString('fr-FR', options));
</script>
</body>
</html>

输出

以上程序以“美式英语”和“标准法语”返回日期字符串。

打印页面