Moment.js チートシート

Moment.js は、JavaScript で日付の解析、検証、操作、書式設定を行うための長年広く使われてきたライブラリです。

日時のパース (解析) と生成

// 現在の日時インスタンスを生成
const now = moment();

// フォーマット文字列を指定してパース
const m = moment('2026-10-25', 'YYYY-MM-DD');

// Unix タイムスタンプからパース (秒単位 vs ミリ秒単位)
moment.unix(1730000000); // 秒単位から
moment(1730000000000);   // ミリ秒単位から

// 日時の妥当性チェック
m.isValid(); // -> true

---

フォーマットトークン

m.format();                  // "2026-10-25T00:00:00+08:00" (// ISO 8601 標準フォーマット)
m.format('dddd');            // "Sunday"
m.format('MMM Do YY');       // "Oct 25th 26"
m.fromNow();                 // "// 相対時間表示 (例: 3 hours ago)"
m.calendar();                // "// カレンダー形式表示"

日付トークン一覧表

時刻トークン一覧表

---

日時の操作と加減算

Moment オブジェクトは ミュータブル (可変) です。加減算などの操作はインスタンスを直接変更します：

// 加算と減算
moment().add(7, 'days');
moment().subtract(1, 'month');

// 単位の境界時刻にセット
moment().startOf('day');  // 本日の 00:00:00.000
moment().endOf('month');  // 月末の 23:59:59.999

// 意図しない変更を防ぐためのクローン複製
const original = moment();
const nextWeek = original.clone().add(7, 'days');

---

ローカライズ済みフォーマットプリセット

---

推奨される最新の代替ライブラリ

現在 Moment.js はメンテナンスモードです。新規開発では以下のモダンなライブラリが推奨されます：

• date-fns: イミュータブルで tree-shaking に対応したモジュール式関数群。
• Day.js: Moment と互換性のある 2KB の軽量代替ライブラリ。
• Luxon: Moment 開発チームによる、標準 Intl API を活用したモダンライブラリ。
• Native Intl.DateTimeFormat: 外部依存なしでモダンブラウザや Node.js に標準搭載された国際化 API。

---

関連リファレンス

• 日付と時刻のフォーマット ISO 8601 チートシート
• JavaScript Date オブジェクト チートシート
• Moment.js 公式ドキュメント
• You-Dont-Need-Momentjs ガイド