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));
}
const timestamp = Date.parse('2024-10-15T10:30:45Z');
const date = new Date(timestamp); // 或直接 new Date('2024-10-15T10:30:45Z')
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']
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;
}
| 方法 | 輸入 | 輸出 | 用途 |
|---|---|---|---|
Date.parse(str) | 字符串 | 毫秒數 (Number) | 解析、比較、驗證 |
new Date(str) | 字符串 | Date 對象 | 創建日期對象 |
Date.UTC(y,m,d...) | 數字分量 | 毫秒數 (UTC) | 構建 UTC 時間戳 |
new Date(y,m,d...) | 數字分量 | Date 對象 (本地) | 構建本地日期對象 |
'2024-10-15' 視為本地午夜,非 UTC。跨時區傳輸**必須帶時區** Z 或 +08:00'24-10-15' 可能被解析為 1924 或 2024,**永遠用四位年份**new Date(2024, 10, 15) 是 11 月,**構造函數月份 0 基**,但字符串解析月份 1 基2024-10-15T10:30:45.123Z)date.toISOString(),計算用 date.getTime()dayjs(str).valueOf()Date.parse() 是字符串轉時間戳的入口,**堅持 ISO 8601 格式**是避免跨瀏覽器、跨時區 Bug 的鐵律。