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


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

引き続きGoogle Apps Scriptでチャットワークに自動でタスクを追加する仕組みを作っています。

以前の記事で毎日のタスクについて自動でチャットワークにタスク追加する方法をお伝えしました。

【GAS】スプレッドシートに記載したタスクを毎日チャットワークに自動で追加する
Google Apps Scriptを使ってスプレッドシートの定期タスクをチャットワークのタスクとして自動で追加するシステムを作ります。今回はスプレッドシートの毎日のタスクについてしぼって実現します。

それで、毎日だけでなく毎月だったり毎週だったりのタスクも自動で追加していきたいので、その事前準備としてスプレッドシートに毎月のタスクについて、次のタスク期限を求めるように数式を仕込みました。

それがこちらの記事です。

GoogleスプレッドシートとExcelで使える日付関連の関数まとめ
Googleスプレッドシートやエクセルで日付に関する処理をする場合も多いですよね。今回は、今日の日付、何か月後の日付、月末日をはじめ両方で全く同じく使える日付関連の関数を一通り紹介したいと思います。

これで準備が整いましたので、今回はGoogle Apps Scriptで毎月、毎週も含む定期のタスクを自動でチャットワークにタスク追加するプログラムを作っていきたいと思います。

では、いってみましょう!

スポンサーリンク

定期タスクのリストをスプレッドシートに準備

まず定期で追加するタスクについてまとめたスプレッドシートがこちらです。

スプレッドシートの定期的なタスクのリスト

A列からタスク内容、ルームID、アカウントID、頻度、設定日、次のタスク期限という構成です。

次のタスク期限はE列が日数であれば今日以降の最初にくるその日数の日付、「末」であれば今日以降の最初にくる末尾の日付が出力されます。

ここについては前回記事をご参考下さい。

GoogleスプレッドシートとExcelで使える日付関連の関数まとめ
Googleスプレッドシートやエクセルで日付に関する処理をする場合も多いですよね。今回は、今日の日付、何か月後の日付、月末日をはじめ両方で全く同じく使える日付関連の関数を一通り紹介したいと思います。

スクリプトの流れ

毎月のタスクについては、タスク期限当日のタスク追加だと、さすがにタスクの消化がしんどいので、期限の3日前に自動でタスクを追加するというルールににします。

スクリプトの流れとしては

  1. スプレッドシートとその最終行数、データの取得をする
  2. スプレッドシートの全ての行について繰り返し
    1. 頻度が「毎日」であれば
      • 期限を本日としてチャットワークにタスクを追加
    2. 頻度が「毎月」であれば
      • 今日の日付がタスク期限の3日前であれば
        • チャットワークにタスクを追加

という流れで進めたいと思います。

チャットワークに定期タスクを追加するスクリプト

スクリプトはこちらです。

function addRegularTasks() {
  
  /* スプレッドシートとその最終行数、データを取得 */
  var mySheet=SpreadsheetApp.getActiveSheet();
  var maxRow=mySheet.getDataRange().getLastRow();
  var myVars=mySheet.getDataRange().getValues();

  var token = 'APIトークン'; //チャットワークAPIトークン
  
  for(var i=2;i<=maxRow;i++){

    var date = new Date(); //今日の日付
    var limit = ""

    var body = myVars[i-1][1-1]; //タスク内容
    var room_id = myVars[i-1][2-1]; //ルームID
    var to_ids = myVars[i-1][3-1]; //アカウントID   

    if(myVars[i-1][4-1] === "毎日"){

      limit = changeUnixTime(date);     
      addTask(token,room_id,body,limit,to_ids);

    } else if(myVars[i-1][4-1] === "毎月"  || myVars[i-1][4-1] === "毎週"){

      var date1 = new Date(myVars[i-1][6-1]); //タスク期限
      var date2 = new Date(date.setDate(date.getDate()+3)); //期限日の3日前に通知

      if(compareDate(date1,date2)){
        limit = changeUnixTime(date1);
        addTask(token,room_id,body,limit,to_ids);
      }
    }   
  }
}

24行目からのif文にて、D列の頻度が「毎日」か「毎月」(または「毎週」)かで分岐をしています。

「毎日」であれば、本日を期限としてチャットワークにタスクを追加します。

日付を固定小数点表記のUNIX時間に変換する関数

changeUnixTimeは日付を固定小数点表記のUNIX時間に変換する関数です。

/* dateを受け取って固定小数点表記のUNIX時間に変換 */
function changeUnixTime(date){

  var limit = date.getTime()/1000;
  return limit.toFixed();

}

なんてことはありませんね。この処理が「毎日」と「毎月」の二か所で必要になったので関数化をしました。

getDateとsetDateで3日後の日付を求める

大元の関数addRegularTasksですが、24行目以降が「毎月」(または「毎週」)だった場合の処理になります。

26行目のdate1には、スプレッドシートのF列「次のタスク期限」に算出されている日付、27行目のdate2には今日の3日後の日付を格納します。

date2ですが二つのメソッドの組み合わせをしています。

まずDateオブジェクトから日数を取り出すgetDateメソッドで日数を取り出しsetDateでDateオブジェクトの日数を設定するときにプラス3をすることで「3日後」の日付を求めています。

setDateは

Dateオブジェクト.setDate(日数)

とすることで、そのDateオブジェクトの日数を設定します。

同じようにget~とset~で何かを書き換えるみたいなことがGASでは結構ありますので、慣れておくと良いと思います。

後日追記:Moment.jsライブラリを使うと簡単に日時の計算ができる

Moment.jsライブラリのaddメソッドを使うと日時の加算が簡単にできるようになりますので、以下ページもご参考下さい。

GASでMoment.jsライブラリを使って簡単に日時の計算をする方法
Google Apps Scriptで日付&時刻の便利ライブラリMoment.jsを使う方法についてお伝えしています。今回はmomentオブジェクトによる日時の加算・減算についてお伝えしていきます。

二つの日付が等しいかを判定する関数

29行目のif文ですが、compareDateというのは二つの日付が等しいかどうかを判定する関数です。

/* 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オブジェクトには年月日だけでなく、時分秒も含まれているので、1秒でもずれていれば等しいという判定になりません。

ということで、年月日だけを比較する関数を作りました(他にスマートな方法があれば教えて欲しい…)。

ちなみに、その際に使っているgetFullYear、getMonthなどのメソッドについては、以下の記事で詳しく説明しているので、ご参考ください。

Google Apps Scriptで特定月のカレンダーのイベント情報を取得する
Googleカレンダーの記録を活用して過去の仕事の生産性を測定するしていきます。今回はGoogle Apps Scriptで特定の月のカレンダーのイベント情報を取得する方法についてお伝えします。

後日追記:Moment.jsライブラリを使うと簡単に日時の比較ができる

Moment.jsライブラリのisSameメソッドを使うと日時の比較が簡単にできるようになりますので、以下ページもご参考下さい。

GAS版Moment.jsライブラリで超簡単に日時の比較をする方法
Google Apps Scriptで日付&時刻の便利ライブラリMoment.jsを使う方法についてお伝えしています。今回はisSame、isBefore、isAfterメソッドで日時の比較をする方法です。

実行結果

では、このスクリプトを実行してみましょう。

チャットワークに自動で定期タスクを追加

このように、当日のタスクが二つ、毎月のタスクが一つ追加されました。

イベントトリガーで毎日に設定をしておけば、毎日のタスクも毎月のタスクもそれぞれがきちんと自動でタスク追加されるようになります。

毎週のタスクにも対応

実はこのスクリプトですが毎週のタスクもそのまま対応しています。

例えばスプレッドシートとして

毎週のタスクもスプレッドシートの定期タスクリストに追加

このようにH列、I列に曜日と値の表を準備します。

F6セルには

=IF(VLOOKUP(E6,$H:$I,2,false)>WEEKDAY(TODAY()),TODAY()+(VLOOKUP(E6,$H:$I,2,false)-WEEKDAY(TODAY())),TODAY()+(VLOOKUP(E6,$H:$I,2,false)-WEEKDAY(TODAY())+7))

などとしています。

もう少しスッキリかけそうな気もしますが、各自研究してみてください。

まとめ

Google Apps Scriptで毎月、毎週、毎日の定期のタスクをチャットワークに自動でタスク追加するプログラムについてお伝えしました。

日付の扱い…スプレッドシートでもGoogle Apps Scriptでもなかなかやっかいかもですね。

ですが、スプレッドシート、Gmail、カレンダーなどといったGASの得意分野を扱う上では避けては通れないと思いますので、ぜひ慣れてしまってほしいと思います。

本連載はこれでひとまず終了となります。

また面白いアイデアを見つけたら紹介していきますので、どうぞお楽しみにしてくださいね。

連載目次:GASでチャットワークに自動でタスク追加をする

タスク管理は重要なのですが、タスクを立てること自体を忘れてしまったりませんか?このシリーズではスプレッドシートとチャットワークを使って定期的なタスクを自動で追加する方法についてお伝えしています。
  1. Google Apps Scriptでチャットワークにタスクを追加する最も簡単なプログラム
  2. Google Apps Scriptでチャットワークに期限付きのタスクを追加する
  3. 【GAS】スプレッドシートに記載したタスクを毎日チャットワークに自動で追加する
  4. GoogleスプレッドシートとExcelで使える日付関連の関数まとめ
  5. 【GAS】定期的に発生するタスクをチャットワークに自動でタスク追加(完全版)

タイトルとURLをコピーしました