萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript Date.setTime() 方法完整指南:毫秒時間戳設定日期

Date.setTime() 以毫秒數(自 UTC 1970-01-01 00:00:00)直接設定 Date 物件的時間值,是處理時間戳轉換的核心方法。

語法與參數

dateObj.setTime(timeValue)
  • timeValue:整數,代表自 Unix Epoch 起的毫秒數
  • 回傳值:設定後的時間毫秒數(即 timeValue)

範例代碼

<script>
var dt = new Date("Aug 28, 2008 23:30:00");
dt.setTime(5000000); // 設為 1970-01-01 06:53:20 UTC
document.write(dt); // 輸出: Thu Jan 1 06:53:20 UTC+0530 1970 (視瀏覽器時區)
</script>

實務應用場景

  • 後端時間戳同步: 伺服器回傳 1704067200000,前端 new Date(timestamp) 或 date.setTime(timestamp) 即時更新
  • 日期運算基準: 取得當日 00:00:00 毫秒數 new Date().setHours(0,0,0,0) 等價於 new Date(new Date().setTime(Math.floor(Date.now()/86400000)*86400000))
  • 跨時區統一儲存: 資料庫儲存 UTC 毫秒數,前端 setTime 後再用 toLocaleString() 顯示本地時間

相關方法對照

方法用途參數
setTime(ms)直接設定毫秒時間戳Number
setFullYear(y, m, d)設定年/月/日Number, Number?, Number?
setHours(h, m, s, ms)設定時/分/秒/毫秒Number, Number?, Number?, Number?
setUTC*對應 UTC 版本同上

注意事項

  • 參數超出範圍(負數、超大)會自動換算月份/年份(如 86400000 為一天)
  • JavaScript 內部以 64 位浮點數儲存毫秒數,精度可達百萬年內毫秒級
  • 配合 Date.now() 獲取當前時間戳,Date.parse() 解析字串
copyright © 萬盛學電腦網 all rights reserved