日付操作ライブラリ比較：date-fns、dayjs、js-joda、luxon、moment

フロントエンド開発で日付を扱う際、適切なライブラリ選びはパフォーマンス・メンテナンス性・開発体験に大きく影響します。この記事では、代表的な5つのJavaScript日付ライブラリ — date-fns、dayjs、js-joda、luxon、moment — を、実務の観点から徹底比較します。

⚠️ 重要な前提：moment.js は非推奨です

まず最初に明確にしておきます。moment は公式に非推奨（deprecated）とされています。npmページおよびGitHubリポジトリには「プロジェクトはメンテナンスモードに入っており、新規プロジェクトでの使用は推奨されない」と記載されています。既存コードの保守には使えますが、新規プロジェクトでは絶対に選ばないでください。以下では比較の公平性のために言及しますが、選択肢としては除外すべきです。

🧩 アーキテクチャ設計：ミュータブル vs イミュータブル

日付ライブラリの根幹となる設計思想は、「オブジェクトを変更するか（ミュータブル）」それとも「新しいインスタンスを返すか（イミュータブル）」です。

moment は ミュータブル です。メソッド呼び出しで元のオブジェクトが変更されます。

// moment: ミュータブル（危険！）
const now = moment();
const tomorrow = now.add(1, 'day');
console.log(now.isSame(tomorrow)); // true ← now も変更されている！

一方、date-fns、dayjs、js-joda、luxon はすべて イミュータブル を採用しています。安全で予測可能な動作が得られます。

// date-fns: イミュータブル
import { addDays } from 'date-fns';
const now = new Date();
const tomorrow = addDays(now, 1);
console.log(now === tomorrow); // false ← 別のインスタンス

// dayjs: イミュータブル
import dayjs from 'dayjs';
const now = dayjs();
const tomorrow = now.add(1, 'day');
console.log(now.isSame(tomorrow)); // false

// js-joda: イミュータブル
import { LocalDate } from 'js-joda';
const today = LocalDate.now();
const tomorrow = today.plusDays(1);
console.log(today.equals(tomorrow)); // false

// luxon: イミュータブル
import { DateTime } from 'luxon';
const now = DateTime.now();
const tomorrow = now.plus({ days: 1 });
console.log(now.hasSame(tomorrow, 'day')); // false

💡 フロントエンド開発では、状態管理との整合性やバグ防止のため、イミュータブル設計が強く推奨されます。この点で moment は時代遅れです。

📦 モジュール設計：ツリーシェイキング対応

バンドルサイズを最適化するには、使った関数だけが含まれる「ツリーシェイキング」対応が必須です。

date-fns は 関数ベース の設計で、個別の関数を直接インポートできます。

// date-fns: 関数単位でインポート → 最小バンドル
import { format, parseISO, addDays } from 'date-fns';

dayjs は 軽量コア + プラグイン 方式です。基本機能は小さいですが、追加機能（例：相対時間、ロケール）はプラグインとして後から読み込みます。

// dayjs: コア + 必要なプラグインのみ
import dayjs from 'dayjs';
import relativeTime from 'dayjs/plugin/relativeTime';
dayjs.extend(relativeTime);

js-joda と luxon は クラスベース で、必要なクラスや静的メソッドをインポートします。ただし、内部的に依存が多い場合があり、完全なツリーシェイキングは難しいことがあります。

// js-joda: クラス単位でインポート
import { LocalDateTime, ZoneId } from 'js-joda';

// luxon: 名前付きインポート
import { DateTime, Duration } from 'luxon';

💡 SPAやモバイル向けアプリでは、date-fns または dayjs がバンドルサイズ面で有利です。

🌍 タイムゾーンと国際化（i18n）対応

グローバルアプリ開発では、タイムゾーンや多言語対応が必須です。

date-fns は タイムゾーン非対応 です。UTCやローカル時刻は扱えますが、任意のタイムゾーン（例：Asia/Tokyo）での計算はできません。i18nは別途 date-fns/locale からロケールをインポートします。

// date-fns: タイムゾーン非対応
import { format } from 'date-fns';
import { ja } from 'date-fns/locale';
format(new Date(), 'yyyy年MM月dd日', { locale: ja });

dayjs は プラグインでタイムゾーン対応 します。timezone プラグインを使えば、任意のタイムゾーンで日付操作が可能です。

// dayjs: タイムゾーンプラグイン
import dayjs from 'dayjs';
import timezone from 'dayjs/plugin/timezone';
import utc from 'dayjs/plugin/utc';
dayjs.extend(utc);
dayjs.extend(timezone);

dayjs.tz('2023-01-01', 'America/New_York').tz('Asia/Tokyo').format();

js-joda は JavaのJSR-310仕様に準拠 しており、ネイティブで強力なタイムゾーンサポート を備えています。ZoneId や ZonedDateTime といったクラスで正確な計算が可能です。

// js-joda: ネイティブタイムゾーン
import { ZonedDateTime, ZoneId } from 'js-joda';
const tokyoTime = ZonedDateTime.now(ZoneId.of('Asia/Tokyo'));

luxon も ネイティブでタイムゾーン対応 しており、ブラウザの Intl API を活用します。設定不要で高精度な変換が可能です。

// luxon: 組み込みタイムゾーン
import { DateTime } from 'luxon';
const tokyo = DateTime.now().setZone('Asia/Tokyo');

💡 タイムゾーンを多用するアプリ（例：スケジューラ、国際物流）では、js-joda か luxon が最適です。dayjs は軽量さを犠牲にせず対応したい場合に検討できます。

🧪 日付のパースとフォーマット

ユーザー入力やAPIレスポンスからの日付パース、表示用フォーマットも重要です。

date-fns は parse と format で柔軟に対応します。フォーマット文字列は独自仕様ですが直感的です。

// date-fns
import { parse, format } from 'date-fns';
const date = parse('2023-01-01', 'yyyy-MM-dd', new Date());
const str = format(date, 'yyyy年MM月dd日');

dayjs は dayjs(string) でISO形式を自動パースし、.format() で出力します。カスタムフォーマットも可能。

// dayjs
const date = dayjs('2023-01-01');
const str = date.format('YYYY年MM月DD日');

js-joda は DateTimeFormatter を使って厳密にパース・フォーマットします。Java経験者には馴染みやすいです。

// js-joda
import { LocalDate, DateTimeFormatter } from 'js-joda';
const formatter = DateTimeFormatter.ofPattern('yyyy-MM-dd');
const date = LocalDate.parse('2023-01-01', formatter);
const str = date.format(formatter);

luxon は DateTime.fromFormat() と .toFormat() を使います。フォーマット文字列はUnicode Technical Standard #35に準拠。

// luxon
import { DateTime } from 'luxon';
const date = DateTime.fromFormat('2023-01-01', 'yyyy-MM-dd');
const str = date.toFormat('yyyy年MM月dd日');

💡 シンプルなユースケースなら date-fns や dayjs で十分。厳密なフォーマット制御が必要なら js-joda、Intl連携重視なら luxon が向いています。

🔁 相互運用性と標準APIとの親和性

他のライブラリや標準APIとの連携も考慮しましょう。

• date-fns: 純粋な Date オブジェクトを入出力するため、他ライブラリとの連携が容易。
• dayjs: .toDate() で Date に変換可能。軽量で多くのプロジェクトで採用されている。
• js-joda: Javaの日付APIに似ているが、JavaScript標準とは異なる。Date との変換には注意が必要。
• luxon: ブラウザの Intl API を内部で使い、Date との変換も簡単。現代的な設計。

📊 まとめ：各ライブラリの特徴と選定基準

💡 最終的なアドバイス

• 新規プロジェクトで moment を使うのは絶対にやめましょう。技術的負債になります。
• 軽量さとシンプルさが最優先 → date-fns か dayjs を選ぶ。
• タイムゾーンや国際化が必須 → luxon（モダンで直感的）か js-joda（計算精度重視）。
• 既存コードが moment なら → 段階的に dayjs（APIが類似）へ移行するのが現実的です。

正しいライブラリを選ぶことで、日付周りのバグを減らし、アプリの信頼性と開発速度を両立できます。