萬盛學電腦網

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

JavaScript Date.parse() 方法:日期字符串轉毫秒時間戳

Date.parse() 方法簡介

Date.parse(dateString) 解析日期時間字符串,返回**自 UTC 1970-01-01 00:00:00 以來的毫秒數**(時間戳)。若解析失敗返回 NaN。

語法

Date.parse(dateString)

支持的字符串格式

瀏覽器實現不一,**強烈建議只使用 ISO 8601 格式**(ES5+ 標準化):

// ✅ 推薦:ISO 8601 (標準、跨瀏覽器一致)
'2024-10-15'              // 日期
'2024-10-15T10:30:45'     // 本地時間
'2024-10-15T10:30:45Z'    // UTC (Zulu)
'2024-10-15T10:30:45+08:00' // 帶時區偏移
'2024-10-15T10:30:45.123Z'  // 含毫秒

// ⚠️ 非標準:瀏覽器兼容性差,避免使用
'Jul 8, 2008'
'July 8, 2008'
'2008/07/08'
'07/08/2008' // 美式 vs 歐式歧義

代碼示例

// 標準 ISO 格式
console.log(Date.parse('2024-10-15T10:30:45Z')); // 1728988245000
console.log(Date.parse('2024-10-15'));           // 當天 00:00 本地時間的毫秒數

// 構造 Date 對象等價
const d1 = new Date('2024-10-15T10:30:45Z');
const d2 = new Date(Date.parse('2024-10-15T10:30:45Z'));
console.log(d1.getTime() === d2.getTime()); // true

// 失敗返回 NaN
console.log(Date.parse('invalid')); // NaN
console.log(Date.parse(''));        // NaN (空字符串)

// 檢測有效日期字符串
function isValidDateString(str) {
    return !isNaN(Date.parse(str));
}

核心應用場景

1. 字符串轉 Date 對象 / 時間戳

const timestamp = Date.parse('2024-10-15T10:30:45Z');
const date = new Date(timestamp); // 或直接 new Date('2024-10-15T10:30:45Z')

2. 日期比較/排序

const dates = ['2024-12-01', '2024-10-15', '2025-01-01'];
dates.sort((a, b) => Date.parse(a) - Date.parse(b));
// ['2024-10-15', '2024-12-01', '2025-01-01']

3. 表單驗證日期有效性

function validateDateInput(input) {
    const timestamp = Date.parse(input.value);
    if (isNaN(timestamp)) {
        showError('日期格式無效,請使用 YYYY-MM-DD');
        return false;
    }
    // 可選:檢查範圍
    if (timestamp < Date.parse('1900-01-01') || timestamp > Date.now()) {
        showError('日期超出允許範圍');
        return false;
    }
    return true;
}

與 new Date() / Date.UTC() 對比

方法輸入輸出用途
Date.parse(str)字符串毫秒數 (Number)解析、比較、驗證
new Date(str)字符串Date 對象創建日期對象
Date.UTC(y,m,d...)數字分量毫秒數 (UTC)構建 UTC 時間戳
new Date(y,m,d...)數字分量Date 對象 (本地)構建本地日期對象

常見坑與避坑指南

  1. 格式依賴瀏覽器:非 ISO 格式在 Safari/舊版 IE 行為不同,**生產環境只用 ISO 8601**
  2. 無時區視為本地:'2024-10-15' 視為本地午夜,非 UTC。跨時區傳輸**必須帶時區** Z 或 +08:00
  3. 兩位數年份:'24-10-15' 可能被解析為 1924 或 2024,**永遠用四位年份**
  4. 月份 0-11 陷阱:new Date(2024, 10, 15) 是 11 月,**構造函數月份 0 基**,但字符串解析月份 1 基

現代最佳實踐

  • 後端 API **統一輸出 ISO 8601 UTC** (2024-10-15T10:30:45.123Z)
  • 前端存儲/傳輸用 date.toISOString(),計算用 date.getTime()
  • 複雜解析/格式化用 dayjs / date-fns:dayjs(str).valueOf()
  • 用戶輸入日期用 `` 原生組件,自動規範格式

Date.parse() 是字符串轉時間戳的入口,**堅持 ISO 8601 格式**是避免跨瀏覽器、跨時區 Bug 的鐵律。

copyright © 萬盛學電腦網 all rights reserved