JavaScript Date valueOf() 方法

JavaScript 的 Date.valueOf() 方法返回一個數值，表示日期物件與紀元之間以毫秒為單位的差值。如果提供的 Date 物件無效，則此方法返回非數字 (NaN)。

紀元是測量時間（以秒為單位）的起點，定義為 1970 年 1 月 1 日 00:00:00 UTC。

語法

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

valueOf();

此方法不接受任何引數。

返回值

此方法返回日期物件與 1970 年 1 月 1 日午夜 UTC 之間的毫秒數。

示例 1

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

<html>
<body>
<script>
   const currentDate = new Date();
   const numericValue = currentDate.valueOf();

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

輸出

程式返回一個整數，該整數指定日期物件與紀元之間的毫秒數。

示例 2

在這裡，我們返回自紀元以來特定日期（2023 年 12 月 26 日 12:30:00）的毫秒數：

<html>
<body>
<script>
   const currentDate = new Date('December 26, 2023 12:30:00');
   const specificDate = currentDate.valueOf();

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

輸出

它返回“1703574000000”毫秒作為輸出。

示例 3

在下面的示例中，日期物件是用無效日期建立的，即日期和時間值超出有效範圍。

<html>
<body>
<script>
   const currentDate = new Date('December 45, 2023 21:78:001');
   const specificDate = currentDate.valueOf();

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

輸出

程式返回“無效日期”作為結果。

列印頁面