Moment.js:日期庫完整講解及實用範例

最後更新: 28的胡里奧·德2025
  • Moment.js 透過簡潔而強大的 API 簡化了 JavaScript 中的日期和時間管理。
  • 允許您以任何格式和時區分析、操作、驗證和顯示日期。
  • 它可以輕鬆整合到專案中,並與 IronPDF 等外部插件和庫相容。

時刻.js

對於 Web 開發人員來說,在 JavaScript 中處理日期和時間可能是一項真正的挑戰。幸運的是,像 Moment.js 這樣的工具可以顯著簡化這個過程,讓從基本的日期格式化到複雜的日期操作和驗證都變得更加輕鬆。如果您曾經因為在專案中轉換、比較或正確顯示日期而感到沮喪,那麼 Moment.js 很可能就是您的得力助手,或者至少您應該考慮使用它。

本文將詳細介紹 Moment.js 的方方面面:從其主要功能和鮮為人知的技巧,到實際示例以及與其他庫的集成,包括對其語法和可用任務的清晰解釋。我們還將探討其局限性、最新更新,以及如果您正在尋找更現代的替代方案,有哪些選擇。

Moment.js 是什麼?為什麼它如此受歡迎?

Moment.js 是一個 JavaScript 函式庫,旨在讓日期和時間的處理變得輕鬆便捷。它允許您使用簡潔而強大的語法,創建、解析、操作和顯示幾乎任何格式的日期。多年來,該程式庫一直是社群克服 JavaScript 原生 Date() 物件限制的主要解決方案。

Moment.js 的核心是`moment()`對象,它幾乎可以根據任何有效輸入構建日期:文字字串、Date 對象、時間戳,甚至直接使用數值參數。這使得它極其靈活,適用於各種項目,從小型腳本到管理國際時區或歷史記錄的企業級應用程式。

它為何如此成功?在於其可靠性、易用性以及豐富的配套工具和插件。即使專案已進入維護模式,Moment.js 仍然擁有龐大的用戶群和詳盡的文檔,鞏固了其作為 JavaScript 和 Node.js 領域領先資料解決方案的地位。

Moment.js 的主要功能和優勢

  • 簡單直覺的 APIMoment.js 最大的優勢之一是其清晰的語法。您只需幾行程式碼即可執行簡單的操作,例如取得當前日期或將字串轉換為特定格式,或執行複雜的計算和驗證。
  • 靈活的解析和格式化解析幾乎任何格式的日期字串並將其轉換為所需的輸出從未如此簡單。 Moment.js 可以快速輕鬆地在自訂簡報中格式化日期。.
  • 日期操作:增加或減去天、月、年、週或任何其他時間單位就像使用方法一樣簡單 加() y 減去()當您需要處理相對日期、截止日期或動態變化的時間範圍時,這非常有用。
  • 穩健驗證:如果您需要檢查某個日期是否有效或是否存在(例如,30 月 XNUMX 日),Moment.js 可以幫助您輕鬆搞定。方法 已驗證() 它能夠檢測日期格式或邏輯中的細微錯誤。
  • 支援時區和本地化: 感謝你的插件 時刻時區在不同時區之間轉換日期非常容易。您還可以根據使用者的語言和區域慣例顯示日期,這在全球應用程式中至關重要。
  • 插件生態系統:除了主庫之外,還有一個插件生態系統來擴展其功能(日曆、與其他框架的兼容性、奇異的格式...)。
  JavaScript 中的正規表示式:簡介

如何在你的專案中開始使用 Moment.js

安裝非常簡單。您只需一行程式碼即可在 HTML 中引入 Moment.js:

<script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.1/moment.min.js"></script>

如果您使用的是 Node.js 或現代開發環境,通常會使用 npm 或 yarn 進行安裝:

npm install moment

完成後,您可以根據使用的語法匯入 Moment.js:

// Versión CommonJS
var moment = require('moment');
moment().format();

// ES6
import moment from 'moment';
moment().format();

建立日期:不同的方式和實際範例

輕鬆建立日期

若要取得目前日期和時間, 只需使用 moment():

console.log(moment()); // Devuelve la fecha actual en formato ISO8601

您可以透過傳遞參數來建構特定的日期:

moment("2022-10-14"); // Crea el 14 de octubre de 2022

您也可以從給定的字串和格式開始,即使在嚴格模式下:

moment("25/12/1995", "DD/MM/YYYY", true); // Analiza y comprueba el formato

您有原生的 Date 物件嗎?

const fechaJS = new Date();
const miFecha = moment(fechaJS);

格式化和顯示日期

Moment.js允許您以任何可以想像的格式顯示日期。例如,要以日/月/年的形式顯示目前日期:

moment().format('DD/MM/YYYY');

如果你想要更人性化的鏈條,你可以使用:

moment().format('MMMM Do YYYY, h:mm:ss a'); // Ejemplo: "marzo 8º 2024, 3:21:10 pm"

一些有用的格式化標記:

  • YYYY:4 位數年份
  • MM: 月
  • DD:月份中的日期
  • hh o HH:時間(12小時或24小時格式)
  • mm: 分鐘
  • ss:秒
  • a:上午/下午

例如,僅顯示時間:

moment().format('HH:mm:ss');

帶有標記和區域支援的高級格式

Moment.js 支援多種在地化格式和翻譯。可以即時切換語言,以另一種語言顯示月份和日期名稱。

moment.locale('es'); // Cambia a español
document.write(moment().format('LLLL'));
// Ejemplo: martes, 8 de marzo de 2024 15:21

日期操作:加法、減法和比較

處理相對日期是 Moment.js 的優勢之一。

  • 新增天數、月份或年份:
    moment().add(3, 'days').format('DD/MM/YYYY');
  • 減去單位:
    moment().subtract(2, 'months').format('DD/MM/YYYY');
  • 經期開始和結束:
    moment().startOf('month').format('DD/MM/YYYY'); // Primer día del mes
    moment().endOf('month').format('DD/MM/YYYY');   // Último día del mes

驗證日期並檢測錯誤

在操作日期之前,請務必驗證其正確性:

moment('2024-02-30', 'YYYY-MM-DD').isValid(); // false, el 30 de febrero no existe

這樣可以防止從用戶接收日期的應用程式中出現意外錯誤。

  如何避免全端開發疲勞與職業倦怠:完整實用的指南

日期比較:檢查某個日期是否在其他日期之中

Moment.js 包含幾種比較日期的方法:

  • 是之前():檢查一個日期是否在另一個日期之前。
  • isAfter():檢查日期是否較晚。
  • isBetween():表示日期是否介於兩個給定日期之間。
let hoy = moment();
let ayer = moment().subtract(1, 'days');
console.log(hoy.isAfter(ayer)); // true

處理時區和國際日期

與世界各地用戶合作時,時區問題可能非常棘手。有了moment-timezone插件,您可以輕鬆地在不同地區之間轉換日期。

const moment = require('moment-timezone');
const fechaUTC = moment('2024-05-25');
const fechaNY = fechaUTC.tz('America/New_York').format('YYYY-MM-DD HH:mm:ss');
console.log(fechaNY);
// Ejemplo: "2024-05-24 20:00:00"

此外,Moment.js 能夠顯示根據使用者區域設定調整後的日期,正確顯示翻譯後的月份和日期名稱。

主要使用範例和高級技巧

取得日期之間的差異

您可以用不同的單位計算兩個日期之間經過的時間:

let inicio = moment('2024-01-01');
let fin = moment('2024-03-08');
let dias = fin.diff(inicio, 'days'); // Devuelve el número de días entre ambas

相對日期和人類時間

Moment.js 非常適合顯示「3 天前」或「5 小時後」之類的訊息:

moment().subtract(3, 'days').fromNow(); // "hace 3 días"
moment().add(2, 'hours').fromNow();    // "en 2 horas"

人類曆法

calendar ()函數顯示相對日期,例如“昨天下午 17:00”、“明天上午 9:00”,使其非常適合用於日曆應用程式。

moment().subtract(1, 'days').calendar(); // "Ayer a las..."
moment().add(3, 'days').calendar();     // "Próximo martes a las..."

支持年份跳躍和特殊日子

您想知道某一年是閏年嗎?

moment([2024]).isLeapYear(); // true

isLeapYear()方法可以直接給出答案。

進階自訂:格式、標記和嚴格解析

Moment.js允許您使用自訂字串和標記來建立或讀取各種格式的日期。此外,嚴格模式要求完全匹配,從而避免了不易察覺的錯誤和意外情況。

  PHP 12 中的 8 個令人驚嘆的新功能

例如,要解析「日/月/年」格式的日期:

moment('12/03/2023', 'DD/MM/YYYY', true);

常見標記清單和範例

  • 年:YYYY (2024), YY (24), Y (-500)
  • MES:MM(01 – 12)、MMM(一月)、MMMM(一月)
  • DIA:DD(01 – 31),C(1日 – 31日)
  • 時間:HH(00 – 23)、hh(01 – 12)、mm(分鐘)、ss(秒)
  • 時區:Z,ZZ

這些代幣可以組合使用,以創建完全自訂的輸出。請參閱文檔,以了解完整清單和特殊情況。

泰克諾數碼

TecnoDigital

我對技術和軟體開發充滿熱情,深入研究系統和計算領域,目的是促進創新和解決複雜的挑戰。