Robi.Run
登入

有想到什麼再寫什麼，沒想到什麼就算了

node.js date-fns-tz 的用法

2024-11-02 00:11 by @robi

在 Node.js 開發中，處理日期和時間是一項常見的任務。date-fns 是一個強大的 JavaScript 日期函式庫，提供豐富的 API 來操作日期。然而，當需要考慮時區時，date-fns 就顯得有些不足。這就是 date-fns-tz 派上用場的地方。

date-fns-tz 是 date-fns 的擴展，它利用 date-fns 的強大功能並添加了對時區支持。通過 date-fns-tz，您可以輕鬆地：

  • 在不同時區之間轉換日期和時間: 您可以將日期時間轉換為不同的時區，例如將台北時間轉換為紐約時間。
  • 格式化日期時間並考慮時區: 您可以使用 format 和 formatISO 等函數來格式化日期時間，並確保輸出的日期時間是特定時區的。
  • 計算時區差異: 您可以使用 differenceInHours 和 differenceInSeconds 等函數來計算兩個時區之間的時間差。
  • 處理時區偏移: 您可以使用 getTimezoneOffset 等函數來獲取特定時區的偏移量。

以下是一些 date-fns-tz 的基本用法示例：

1. 安裝 date-fns-tz:

npm install date-fns-tz

2. 導入所需函數:

const { format, parse, zonedTimeToUtc, utcToZonedTime } = require('date-fns-tz');

3. 轉換日期時間:

// 將台北時間轉換為紐約時間
const taipeiTime = new Date();
const newYorkTime = utcToZonedTime(taipeiTime, 'America/New_York');
console.log('台北時間:', format(taipeiTime, 'yyyy-MM-dd HH:mm:ss', { timeZone: 'Asia/Taipei' }));
console.log('紐約時間:', format(newYorkTime, 'yyyy-MM-dd HH:mm:ss'));

// 將紐約時間轉換為台北時間
const newYorkTime2 = new Date('2023-12-01T12:00:00');
const taipeiTime2 = zonedTimeToUtc(newYorkTime2, 'America/New_York');
console.log('紐約時間:', format(newYorkTime2, 'yyyy-MM-dd HH:mm:ss', { timeZone: 'America/New_York' }));
console.log('台北時間:', format(taipeiTime2, 'yyyy-MM-dd HH:mm:ss', { timeZone: 'Asia/Taipei' }));

4. 格式化日期時間:

// 格式化台北時間
const now = new Date();
const formattedDate = format(now, 'yyyy-MM-dd HH:mm:ss', { timeZone: 'Asia/Taipei' });
console.log(formattedDate); // 輸出類似 "2023-12-01 12:00:00" 的格式化日期時間

// 格式化紐約時間
const newYorkTime3 = new Date('2023-12-01T12:00:00');
const formattedDate2 = format(newYorkTime3, 'yyyy-MM-dd HH:mm:ss', { timeZone: 'America/New_York' });
console.log(formattedDate2); // 輸出類似 "2023-12-01 00:00:00" 的格式化日期時間

5. 計算時區差異:

// 計算台北時間和紐約時間之間的時區差異
const taipeiTime3 = new Date();
const newYorkTime4 = new Date();
const difference = differenceInHours(taipeiTime3, newYorkTime4, { timeZone: 'Asia/Taipei' });
console.log(difference); // 輸出兩個時區之間的時區差異，例如 -13

6. 處理時區偏移:

// 獲取台北時間的時區偏移量
const taipeiTime4 = new Date();
const offset = getTimezoneOffset(taipeiTime4, { timeZone: 'Asia/Taipei' });
console.log(offset); // 輸出台北時間的時區偏移量，例如 28800 秒（即8小時）

使用 date-fns-tz 的注意事項：

  • date-fns-tz 需要 date-fns 作為依賴項，確保您已安裝 date-fns。
  • 請確保您使用的時區名稱正確。可以使用 IANA Time Zone Database 來查找正確的時區名稱。
  • date-fns-tz 的 API 設計與 date-fns 相似，因此您可以輕鬆地將兩者結合使用。

date-fns-tz 提供了一個方便且強大的工具，用於在 Node.js 中處理日期和時間，並考慮時區。它可以簡化您的代碼，並確保您處理的日期時間信息是準確的。

提示