萬盛學電腦網

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

JavaScript Date 對象構造與參數解析完整指南

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)

現代最佳實踐

  1. 優先使用 ISO 8601 字符串:new Date('2023-12-12T10:30:00') 或 new Date('2023-12-12T10:30:00Z') (UTC)
  2. 構造函數用數值參數:new Date(year, monthIndex, day) 明確月份 0 基索引
  3. 避免兩位數年份:new Date(99, 0, 1) 被解析為 1999 年
  4. 日期運算使用庫:date-fns、Day.js、Moment.js(維護模式)
  5. 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();   // 本地化格式
copyright © 萬盛學電腦網 all rights reserved