Date 構造函數 5 種重載形式
| 形式 | 語法 | 示例 | 說明 |
| 1. 日期字符串 |
new Date(dateString) |
new Date("2023-12-12") |
自動調用 Date.parse(),格式依賴實現,推薦 ISO 8601 |
| 2. 日期字符串(美式) |
new Date("month dd,yyyy hh:mm:ss") |
new Date("December 12, 2023 22:19:35") |
月份英文名,區域敏感 |
| 3. 多參數數值(本地時間) |
new Date(year, month, day, hours, minutes, seconds, ms) |
new Date(2023, 11, 12, 22, 19, 35) |
月份 0-11,日 1-31,其余默認 0,返回本地時間 |
| 4. 多參數數值(UTC) |
new Date(Date.UTC(year, month, day, ...)) |
new Date(Date.UTC(2023, 11, 12)) |
參數同形式3,但按 UTC 解析,返回 UTC 時間戳 |
| 5. 時間戳毫秒數 |
new Date(timestamp) |
new Date(1702400375000) |
相對 1970-01-01 UTC 的毫秒數 |
關鍵差異:本地時間 vs UTC
// 本地時間構造 (瀏覽器時區)
const local = new Date(2023, 11, 12); // 2023-12-12 00:00:00 本地時間
// UTC 構造
const utc = new Date(Date.UTC(2023, 11, 12)); // 2023-12-12 00:00:00 UTC
console.log(local.getTime() === utc.getTime()); // false,相差時區偏移量
console.log(local.toISOString()); // "2023-12-11T16:00:00.000Z" (假設 UTC+8)
console.log(utc.toISOString()); // "2023-12-12T00:00:00.000Z"
Date.parse() 與 Date.UTC() 詳解
// Date.parse: 字符串 -> 時間戳
Date.parse("2023-12-12"); // ISO 格式推薦
Date.parse("Dec 12, 2023"); // 支持但依賴實現
Date.parse("12/12/2023"); // 極不推薦,歧義大
// Date.UTC: 數值參數 -> UTC 時間戳
Date.UTC(2023, 11, 12, 10, 30, 0); // 必須提供年、月(0-11)
現代最佳實踐
- 優先使用 ISO 8601 字符串:
new Date('2023-12-12T10:30:00') 或 new Date('2023-12-12T10:30:00Z') (UTC)
- 構造函數用數值參數:
new Date(year, monthIndex, day) 明確月份 0 基索引
- 避免兩位數年份:
new Date(99, 0, 1) 被解析為 1999 年
- 日期運算使用庫:date-fns、Day.js、Moment.js(維護模式)
- Temporal 提案:未來標準 API,當前可用 Polyfill
常用實用方法速查
const d = new Date();
d.getFullYear(); // 年
d.getMonth(); // 月 0-11
d.getDate(); // 日 1-31
d.getDay(); // 星期 0-6 (0=周日)
d.getHours(); // 時 0-23
d.getMinutes(); // 分
d.getSeconds(); // 秒
d.getMilliseconds(); // 毫秒
d.getTime(); // 時間戳
d.toISOString(); // ISO 8601 UTC 字符串
d.toLocaleString(); // 本地化格式