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>

輸出

以上程式以“美式英語”和“標準法語”返回日期字串。

列印頁面