Date對象可能是最令JavaScript開發者頭疼的API之一。無論是處理時區轉換、格式化日期，還是計算日期差異，傳統的Date對象總是讓人感到困惑和不便。好消息是，全新的Temporal API正在改變這一切，它旨在解決JavaScript中日期和時間處理的諸多痛點。

JavaScript Date對象的痛點

在深入了解Temporal API之前，我們先回顧一下使用傳統Date對象時常遇到的問題：

• 月份從0開始計數：一月是0，二月是1，這違背了人類的直覺
• 時區處理混亂：缺乏明確的時區支持，導致跨時區操作困難
• 可變性問題：Date對象是可變的，容易引起意外的副作用
• 操作不便：缺少便捷的日期計算和比較方法
• 格式化能力有限：需要依賴額外的庫來進行日期格式化

這些問題促使TC39委員會提出了Temporal API作為現代JavaScript的日期時間解決方案。

Temporal API：現代化的日期時間處理

Temporal API是一個全新設計的日期和時間API，它提供了一套完整、直觀且不可變的對象來處理日歷日期和時鐘時間。

核心特性：

• 直觀易用：月份從1開始，符合人類習慣
• 不可變對象：所有操作都返回新實例，避免副作用
• 明確的時區支持：內置時區處理功能
• 豐富的操作方法：提供各種日期計算、比較和格式化方法
• 精確的時間單位：從納秒到年的精確時間單位支持

Temporal API的主要組件

Temporal API引入了多個專門的對象，每個對象都針對特定的日期時間場景：

• Temporal.Now：獲取當前日期和時間
• Temporal.PlainDate：處理不含時間的日歷日期
• Temporal.PlainTime：處理不含日期的時鐘時間
• Temporal.PlainDateTime：處理不含時區的日期和時間
• Temporal.ZonedDateTime：處理帶有時區的日期和時間
• Temporal.Duration：表示時間段
• Temporal.Instant：表示時間軸上的精確時刻

實際應用示例

(1) 創建日期和時間

// 創建當前日期
const today = Temporal.Now.plainDateISO();
console.log(today.toString()); // 輸出：2025-04-16

// 創建特定日期
const birthday = Temporal.PlainDate.from({ year: 2025, month: 7, day: 15 });
console.log(birthday.toString()); // 輸出：2025-07-15

// 創建日期時間
const meeting = Temporal.PlainDateTime.from({
year: 2025, month: 4, day: 20, 
hour: 14, minute: 30
});
console.log(meeting.toString()); // 輸出：2025-04-20T14:30:00

(2) 日期計算

(3) 時區處理

(4) 日期格式化

Temporal API與Date對象的對比

瀏覽器支持與兼容性

截至2025年4月，Temporal API已經在主流瀏覽器中得到支持，但仍處于持續發展階段。如果需要在較舊的瀏覽器中使用，可以考慮使用polyfill：

// 使用polyfill
import { Temporal } from '@js-temporal/polyfill';