5 種構造形式對比
| # | 語法 | 參數說明 | 示例 | 結果 (假設 UTC+8) |
| 1 |
new Date('month dd,yyyy hh:mm:ss') |
英文月份名、日、年、時分秒 |
new Date('January 12,2006 22:19:35') |
2006-01-12 22:19:35 本地時間 |
| 2 |
new Date('month dd,yyyy') |
英文月份名、日、年 |
new Date('January 12,2006') |
2006-01-12 00:00:00 本地時間 |
| 3 |
new Date(yyyy, mth, dd, hh, mm, ss) |
年、月(0-11)、日、時、分、秒 |
new Date(2006, 0, 12, 22, 19, 35) |
2006-01-12 22:19:35 本地時間 |
| 4 |
new Date(yyyy, mth, dd) |
年、月(0-11)、日 |
new Date(2006, 0, 12) |
2006-01-12 00:00:00 本地時間 |
| 5 |
new Date(ms) |
毫秒時間戳 (距 1970-01-01 UTC) |
new Date(1137075575000) |
2006-01-12 22:19:35 本地時間 |
關鍵陷阱與避坑指南
❌ 陷阱 1:月份 0 基索引
new Date(2023, 12, 1); // ❌ 錯誤!月份 12 會溢出到 2024 年 1 月
new Date(2023, 11, 1); // ✅ 正確:11 代表 12 月
❌ 陷阱 2:字符串解析不一致
// 不同瀏覽器/環境解析結果可能不同
new Date('2023-12-12'); // ✅ ISO 8601 標準,推薦
new Date('2023/12/12'); // ⚠️ 部分環境視為本地,部分視為 UTC
new Date('12/12/2023'); // ❌ 極不推薦:美式/英式歧義
new Date('December 12, 2023'); // ⚠️ 依賴區域設置
❌ 陷阱 3:傳入字符串數字而非數值
const year = '2023', month = '0', day = '12'; // 從表單獲取的字符串
new Date(year, month, day); // ❌ 字符串拼接導致 NaN 或錯誤解析
new Date(Number(year), Number(month), Number(day)); // ✅ 顯式轉數值
❌ 陷阱 4:兩位數年份
new Date(99, 0, 1); // 1999 年 (非 2099)
new Date(23, 0, 1); // 1923 年
// 規則:0-99 映射 1900-1999,建議始終用四位數年份
現代最佳實踐
1. 統一使用 ISO 8601 字符串
// 本地時間
new Date('2023-12-12T22:19:35');
// UTC 時間 (Z 後綴)
new Date('2023-12-12T22:19:35Z');
// 帶時區偏移
new Date('2023-12-12T22:19:35+08:00');
2. 使用輔助函數封裝
function createDate(year, month, day, hours = 0, minutes = 0, seconds = 0) {
// month: 1-12 人類直觀
return new Date(year, month - 1, day, hours, minutes, seconds);
}
function createUTCDate(year, month, day, hours = 0, minutes = 0, seconds = 0) {
return new Date(Date.UTC(year, month - 1, day, hours, minutes, seconds));
}
3. 推薦日期處理庫
時間戳獲取對比
const now = new Date();
now.getTime(); // ES5 標準
now.valueOf(); // 同 getTime()
Number(now); // 隱式轉換
+now; // 一元加號,最簡潔
Date.now(); // 靜態方法,無需創建對象 (性能最優)