JavaScript toLocaleTimeString() 方法

JavaScript 中的 Date.toLocaleTimeString() 方法用於根據特定於區域設定的時間格式將 Date 物件轉換為表示日期時間部分的字串。

語法

以下是 JavaScript Date toLocaleTimeString() 方法的語法：

toLocaleTimeString(locales, options);

引數

此方法接受兩個引數。下面描述了這些引數：

locales (可選) − 此引數可選，表示帶有 BCP 47 語言標籤的字串或此類字串的陣列。它指定要使用的區域設定。如果未提供此引數或未定義，則使用 JavaScript 執行時的預設區域設定。
options (可選) − 一個可選引數，表示一個物件，其中包含自定義輸出的屬性。這些屬性包括：
- timezone 指定要使用的時區。預設為執行時的預設時區。
- hour12 一個布林值，指示是否使用 12 小時制 (true) 或 24 小時制 (false)。預設為執行時的預設設定。
- hour 一個字串，其值例如 "numeric"、"2-digit" 或 undefined。
- minute 一個字串，其值例如 "numeric"、"2-digit" 或 undefined。
- second 一個字串，其值例如 "numeric"、"2-digit" 或 undefined。
- timeZoneName 一個字串，其值例如 "short"、"long" 或 undefined。

返回值

此方法根據當前區域設定的約定返回日期物件的 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) 格式顯示，而不是帶有 AM/PM 的預設 12 小時制格式。

<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。

列印頁面