JavaScript Date toLocaleDateString() 方法

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

toLocaleDateString() 方法返回一个字符串，该字符串根据特定于语言环境的约定和格式选项表示给定 Date 对象的日期部分。返回字符串的格式可能因语言环境和提供的选项而异。

语法

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

toLocaleDateString(locales, options);

参数

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

• locales (可选) - 表示 BCP 47 语言标签的字符串或字符串数​​组，或此类字符串的数组。它指定用于日期格式的一个或多个语言环境。如果 locales 参数未定义或为空数组，则使用运行时的默认语言环境。
• options (可选) - 包含用于自定义日期格式的属性的对象。此对象可以具有"星期"、"年"、"月"、"日"等属性。每个属性可以具有"数字"、"2 位"、"长"、"短"或"窄"等值，以自定义日期相应部分的显示。

返回值

此方法仅返回日期对象的日期(非时间)，并使用语言环境约定作为字符串。

示例 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>

输出

上述程序返回"美式英语"和"标准法语"的日期字符串。