Date 物件的 getTime() 會回傳一個數字:從 1970 年 1 月 1 日 00:00:00 UTC 到該時刻之間的毫秒數。這就是所謂的 Unix 時間戳(在 JavaScript 中的形式)。
<!DOCTYPE html>
<html>
<body>
<p id="demo">Click the button to display the number of milliseconds since midnight, January 1, 1970.</p>
<button onclick="myFunction()">Try it</button>
<script>
function myFunction() {
var d = new Date();
var x = document.getElementById("demo");
x.innerHTML = d.getTime();
}
</script>
</body>
</html>
JavaScript 回傳的是毫秒,而多數其他語言與工具(Unix date +%s、資料庫的 epoch 欄位、許多重付息參數)用的是秒。跨系統對接時這是最常見的錯誤來源:
var ms = Date.now(); // 1␣7... 13 位數(毫秒) var s = Math.floor(ms / 1000); // 10 位數(秒)
Date.now() // 直接取得當前毫秒數,不必 new Date() +new Date() // 一元加號會觸發 valueOf(),效果相同 new Date().valueOf() // 明確呼叫 valueOf
因為它是一個與時區、語言、格式都無關的純數字。要計算兩個時刻相差多久,直接相減即可;要排序一長串時間,比數字比字串快也準。這也是為什麼 API 之間傳時間,除了 ISO 8601 之外,時間戳是最受歡迎的選擇。