GAS版Moment.jsライブラリで超簡単に日時の比較をする方法

photo credit: roman.kopacek train station Jablonec nad Nisou view from the bridge via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

Google Apps Scriptで日付＆時刻の便利ライブラリMoment.jsを使う方法についてお伝えしています。

前回の記事はコチラ。

Google Apps ScriptのMoment.jsで日時の各要素をGetとSetする方法

Google Apps Scriptで日付＆時刻の便利ライブラリMoment.jsを使う方法についてお伝えしています。今回はmomentオブジェクトから各要素を取得する方法、またセットする方法です。

momentオブジェクトの各要素を取り出したり、セットしたりする方法についてお伝えしました。

今回は、二つのmomentオブジェクトが表す日時が等しいか、以前か、以降か…といった比較について考えてみたいと思います。

これもMoment.jsライブラリを使うと、Dateオブジェクトを使うよりも劇的に簡単に表現することができるんですね。

では、Google Apps ScriptのMoment.jsライブラリで日付の比較をする方法です。

行ってみましょう！

Dateオブジェクトの比較
isSameメソッドでmomentオブジェクトが等しいか判定する
他のmomentオブジェクトを比較するメソッド
まとめ
連載目次：Google Apps ScriptでMoment.jsを使う

Dateオブジェクトの比較

もっと他の良い方法があるのかも知れないのですが、二つのDateオブジェクトの年、月、日を比較する場合に、過去こんな関数を作成していたんですね。

/* 2つの日付が等しいかを比較する */
function compareDate(date1,date2){

  if(date1.getFullYear() === date2.getFullYear() && date1.getMonth() === date2.getMonth() && date1.getDate() === date2.getDate()){
    return true;
  }else{
    return false;
  }

}

if(date1 === date2)みたいに表現したいのですが、dateオブジェクトには年月日だけでなく、時分秒の要素も含まれているので、年月日が等しいかどうかを判定したい場合は、このように表現せざるを得ないのです。

んー、スマートじゃないですよね…

【GAS】定期的に発生するタスクをチャットワークに自動でタスク追加（完全版）

チャットワークのタスク機能ですが、定期のタスク追加は面倒ですよね。今回はGoogle Apps Scriptで毎月、毎週、毎日の定期タスクを自動でチャットワークに追加するプログラムを作成します。

isSameメソッドでmomentオブジェクトが等しいか判定する

これが、momentオブジェクトだと、超スッキリ表現ができます。

二つのmomentオブジェクトの要素が等しいかどうかは、momentオブジェクトにisSameメソッドを使いまして、このように書きます。

momentオブジェクト.isSame(日付, 要素を表す文字列)

日付はいくつかの指定の仕方がありまして

・momentオブジェクト
・Dateオブジェクト
・日時を表す文字列
・配列 ※例：[2020, 2, 3, 12, 0, 0] ※monthは0～11の値
・UNIX時間×1000

のいずれかで指定します。

要素を表す文字列は

・year
・month
・week
・day
・hour
・minute
・second

のいずれかを文字列で指定します。この点、詳細は後ほどのお楽しみ。

第二引数は省略もできますが、省略をするとmomentオブジェクト同士をそのまま比較しますので、年～ミリ秒までピッタリかどうかを判定します。

isSameメソッドによる年の比較

二つのmomentオブジェクトの年が等しいかどうか知りたいなら、要素を表す文字列を「year」として

Moment.moment('2020/2/3').isSame('2020/3/4','year'); //true
Moment.moment('2020/2/3').isSame('2019/2/3','year'); //false

とします。

isSameメソッドによる年月日の比較

では、年月日を知りたい場合はどうしますか？

その場合は、要素を表す文字列を「day」とします。

Moment.moment('2020/2/3 16:55').isSame('2020/2/3 17:00','day'); //true
Moment.moment('2020/2/3').isSame('2020/2/2','day'); //false
Moment.moment('2020/2/3').isSame('2020/1/3','day'); //false
Moment.moment('2020/2/3').isSame('2019/2/3','day'); //false

わかりますか？

要素を表す文字列を指定すると、それよりも上位の要素全てを比較してくれるんですね。ですから、「day」を指定すると、「year」「month」も同じかどうかを比較してくれます。

ですから冒頭の関数compareDateは

Moment.moment(date1).isSame(date2,'day'); //true

これで表現ができちゃうということになります。

スマート！

isSameメソッドによる週の比較

同様にweekを使えば

Moment.moment('2020/2/3').isSame('2020/2/4','week'); //true
Moment.moment('2020/2/3').isSame('2020/2/5','week'); //false

同じ週かどうかを判定することができます。

これは便利！！

他のmomentオブジェクトを比較するメソッド

Moment.jsライブラリには他にもmomentオブジェクトを比較する便利なメソッドがありますので紹介しますね。

IsBeforeメソッドで前の日時かを判定する

momentオブジェクトが指定の日付よりも前かどうかを判定する場合はisBeforeメソッドを使います。

momentオブジェクト.isBefore(日付, 要素を表す文字列)

Moment.moment('2020/2/3').isBefore('2020/2/2'); //false
Moment.moment('2020/2/3').isBefore('2020/2/3'); //false
Moment.moment('2020/2/3').isBefore('2020/2/4'); //true

IsAfterメソッドで後の日時かを判定する

momentオブジェクトが指定の日付よりも後かどうかを判定する場合はisAfterメソッドを使います。

momentオブジェクト.isAfter(日付, 要素を表す文字列)

Moment.moment('2020/2/3').isAfter('2020/2/2'); //true
Moment.moment('2020/2/3').isAfter('2020/2/3'); //false
Moment.moment('2020/2/3').isAfter('2020/2/4'); //false