「何を今さら」って感じのタイトルですが、最近 初めて luxon を使うことがありまして「へぇ〜〜〜」って思ったことが色々あったのでまとめていきます。 当方 moment, dayjs しか使ったことがなかったので、「こういう差分があるんだなぁ」と学んだという話です。
immutable
moment では、
const now = moment();
console.log("now", now);
const addNow = now.add(1, "days"); // これをやるとnowそのものが書き換わるから注意！
console.log("addNow", addNow);
// now Moment<2020-11-20T17:02:09+09:00>
// addNow Moment<2020-11-21T17:02:09+09:00>などとすると、now も変更されていました。
console.log の位置を変えると、
const now = moment();
const addNow = now.add(1, "days"); // これをやるとnowそのものが書き換わるから注意！
console.log("now", now);
console.log("addNow", addNow);
// now Moment<2020-11-21T17:00:54+09:00>
// addNow Moment<2020-11-21T17:00:54+09:00>として表示されます。
一方で luxon だと
const luxon = require("luxon");
const now = luxon.DateTime.local();
console.log("now", now);
const addNow = now.plus(1, "days");
console.log("addNow", addNow);としても now は変更されません。
moment の後継ライブラリは基本的に immutable になっています。
デフォルトインポートした関数を使えない
moment や dayjs は日付オブジェクトを作成するとき、
const now = moment();
console.log("now", now);などとできますが、luxon では DateTime というクラス（と呼んでいいかは知らないけど）を使って作る必要があります。
const luxon = require("luxon");
const now = luxon.DateTime.local();
console.log("now", now);dayjs も moment も inport したモジュールから直接オブジェクトを作れていたのでこの挙動は最初はハマりました。
比較関数がない
DateTime にはいわゆる isAfter や isBefore のような関数が存在しません。 一応そのようなインターフェースは Interval というパッケージに含まれていますが、これは moment-range 相当のものですのでただ比較するだけに持ち出すのはオーバーなものです。 それに 公式 の推奨方法は違ったものです。 それはただ
d1 < d2;とするだけです。(d1, d2 は DateTime 型)
DateTime 型は valueOf としてタイムスタンプへの変換が実装されており、それは比較前に実行されるのでこのような比較方法でも前後を比較できます。
FYI: Object.prototype.valueOf()
FYI: 比較演算子
date(日付) だけにフォーマットできる
YYYY-MM-DD 形式で取得するとき、moment だと
// 日付までを表記
const formatDate = moment().format("YYYY-MM-DD");
console.log("formatDate", formatDate);としていたものが、
// 日付までを表記
const formatDate = now.toISODate();
console.log("formatDate", formatDate);として取得できて便利でした。 カレンダー作るときとかに使えますね。
timezone は標準で扱える
moment だとrequire("moment-timezone"); とすることで、.tzを生やしていました。
const samoa = utc.tz("Pacific/Apia");
console.log("samoa", samoa);それが luxon では setZone として標準で使えます。
const samoa = now.setZone("Pacific/Apia");
console.log("samoa", samoa);便利。
まとめ
dayjs が割と moment 気分で使えることもあり、そのようなインターフェースに慣れ切っていた自分にとって luxon は調べながらでないと満足にコードを書けなくて少し辛かったのですが、使い方さえ覚えたら moment より便利になっているなぁと感じられました。 ただ自分は moment のインターフェースに慣れ切っているので dayjs の方を好んで使うかなぁと思います。
