【GAS】取得した複数のGoogleカレンダーのイベントをソートしたい

Question

GASを利用して、Googleカレンダーから複数のカレンダーのイベントを取得し、Chatworkのルームに転記しています。
問題なく動いていますが、以下のように表示されるため、開始時間でソートしたいと考えています。

Chatworkに転記した結果

09:00 - 10:00 : A　面談
11:00 - 12:00 : A　面談
08:30 - 09:30 : B　外出
13:30 - 16:00 : B　外出
10:00 - 17:00 : C　委員会

該当のソースコード

function notifyDuty() {
  var date = new Date();

  if(isBusinessDay(date)){
    deleteTrigger();
    get_Today_Schedule();
  }else{
     Logger.log('休日です');
  }
}

// その日の8時30分にトリガーを設定
function setTrigger() {
  var triggerDay = new Date();
  triggerDay.setHours(8);
  triggerDay.setMinutes(30);
  ScriptApp.newTrigger("notifyDuty").timeBased().at(triggerDay).create();
}

// その日のトリガーを削除する関数(消さないと残る)
function deleteTrigger() {
  var triggers = ScriptApp.getProjectTriggers();
  for(var i=0; i < triggers.length; i++) {
    if (triggers[i].getHandlerFunction() == "notifyDuty") {
      ScriptApp.deleteTrigger(triggers[i]);
    }
  }
}

//営業日の判断をする関数
function isBusinessDay(date){
  if (date.getDay() == 0 || date.getDay() == 6 ) {
    return false;
  }
  var calJa = CalendarApp.getCalendarById('addressbook#[e-mail]');
  if(calJa.getEventsForDay(date).length > 0){
    return false;
  }
  return true;
}

/*カレンダーのIDを取得*/
function get_Calendar() {
  var arrCals=[];
  arrCals.push(CalendarApp.getCalendarById('[e-mail]'));//A
  arrCals.push(CalendarApp.getCalendarById('[e-mail]'));//B
  arrCals.push(CalendarApp.getCalendarById('[e-mail]'));//C
  return arrCals;
}

/*今日の予定を取得するメインの関数*/
function get_Today_Schedule(){
  var arrCals = get_Calendar();//カレンダーID取得
  var date = new Date();
  date.setDate(date.getDate());//日付に今日を指定
  var strIntro =  "[info][title]今日の予定[/title]";
  var strBody = strIntro;
  /*カレンダーの今日のイベント取得*/
  for (var i = 0 ; i< arrCals.length ; i++){
    strBody = strBody + getEvents(arrCals[i],date);
  }
  
  if (strBody == strIntro){
    strBody = "[info][title]今日の予定[/title]予定はありません。" ;
  }
  
  strBody = strBody + '[/info]';
  
  /* チャットワークにメッセージを送る */
  var cwClient = ChatWorkClient.factory({token: 'xxxx'});　//チャットワークAPI
  cwClient.sendMessage({
    room_id:xxxx, //送信先ルームID
    body: strBody
  }); 
}
 
/*カレンダーのイベント取得*/
function getEvents(Cals,getDate){
  var arrEvents = Cals.getEventsForDay(getDate);
  var strEvents ="";
  for (var i=0; i<arrEvents.length; i++){
    var strTitle = arrEvents[i].getTitle();
    var strStart = _HHmm(arrEvents[i].getStartTime());　//開始時刻
    var strEnd = _HHmm(arrEvents[i].getEndTime());　//終了時刻
    if (strStart == strEnd){
      strEvents = strEvents + '終日イベント：' + strTitle + '\n';
    }else{
      strEvents = strEvents + strStart + ' - ' + strEnd+ ' : '  + strTitle + '\n';
    }
  }
  return strEvents;
}

/*時間の表示変更*/
function _HHmm(str){ 
  return Utilities.formatDate(str,'JST','HH:mm');
}

考えていること

strEventsの辺りに処理を追加するか、一度スプレッドシートに書き出してソートするのも解決策かと思いますが、どちらも具体的なコードまでイメージできていません。

Answer 1

このコードを前任者(?)が考えたときは、カレンダーごとにイベントを出すことに意味を感じてたのではないかと思いました。

イベントが時刻順に並んでないことは、この通知を見る全員にかかわりのあるイベントでは奇妙かもしれませんが、個人やチームごと、あるいは取引先グループごとにカレンダーを管理している場合などにはこういう出しかたをすることがむしろ有効である状況が考えられます。

そうなってくると、カレンダー名を出したほうがいいのかとか、いろいろ考えることが広がるので、これをこのまま使い回して有用なのかが疑問です。

const notifyDuty = () => {
    if(isBusinessDay(new Date())){
        deleteTrigger();
        send(get_Today_Schedule());
        return;
    }
    Logger.log('休日です');
}

// その日の8時30分にトリガーを設定
const setTrigger = () => {
    const today = new Date();
    today.setHours(8,30);
    ScriptApp.newTrigger("notifyDuty").timeBased().at(today).create();
}

// その日のトリガーを削除する関数(消さないと残る)
const deleteTrigger = () => {
    for(const trigger of ScriptApp.getProjectTriggers()) {
        if (trigger.getHandlerFunction() == "notifyDuty") {
            ScriptApp.deleteTrigger(trigger);
        }
    }
}

//営業日の判断をする関数
const isBusinessDay = (date) => {
    if (date.getDay() == 0 || date.getDay() == 6 ) {
        return false;
    }
    const calJa = CalendarApp.getCalendarById('addressbook#[e-mail]');
    if(calJa.getEventsForDay(date).length > 0){
        return false;
    }
    return true;
}

/*カレンダーのIDを取得*/
const get_Calendar = () => [
    CalendarApp.getCalendarById('[e-mail]'),//A
    CalendarApp.getCalendarById('[e-mail]'),//B
    CalendarApp.getCalendarById('[e-mail]'),//C
];

/*今日の予定を取得するメインの関数*/
const get_Today_Schedule = () => {
    const today = new Date(); //日付に今日を指定
    const events = get_Calendar().map(c => c.getEventsForDay(today)).flat().sort(calendarEventspararer);
    if(events.length < 1) return "[info][title]今日の予定[/title]予定はありません。[/info]";
    let message = "[info][title]今日の予定[/title]";
    message += getEvents(events);
    message += '[/info]';
    return message;
}

/*カレンダーのイベントを文字化*/
const getEvents = (events) => {
    let eventMessage = "";
    for (const event of events){
        const title = event.getTitle();
        if(event.isAllDayEvent()) {
            eventMessage += `終日イベント：${strTitle}\n`;
            continue;
        }
        const start = _HHmm(event.getStartTime());　//開始時刻
        const end = _HHmm(event.getEndTime());　//終了時刻
        eventMessage += `${start} - ${end} : ${title}\n`;
    }
    return eventMessage;
}

/* チャットワークにメッセージを送る */
const send = (message) => {
    const cwClient = ChatWorkClient.factory({token: 'xxxx'});　//チャットワークAPI
    cwClient.sendMessage({
        room_id:"xxxx", //送信先ルームID
        body: message
    });
}
/*時間の表示変更*/
const _HHmm = (date) => Utilities.formatDate(date,'JST','HH:mm');

const calendarEventspararer = (event1, event2) => {
    if(event1.getStartTime() > event2.getStartTime()) { return 1;}
    if(event1.getStartTime() < event2.getStartTime()) { return -1;}
    if(event1.getEndTime() > event2.getEndTime()) { return 1;}
    if(event1.getEndTime() < event2.getEndTime()) { return -1;}
    return 0;
}

Answer 2

getEventsでは1つの文字列にループで予定を付け足していったものを返しており、
これをループで呼び出して、その結果もまた1つの文字列に付け足していっていますね。
つまり二重ループで1つの文字列をつくっていることになります。

1つの文字列にしてしまってからでは並べ替えは難しいですから、
まずは上記の処理を、1つの文字列に付け足していくのではなく、
予定を配列の要素として加えていくよう変えるべきだと思います。

配列に要素を追加するにはArray.push()などを用います。

Array.prototype.push() - JavaScript | MDN

そうして予定を配列にすれば、Array.sort()で好きなように並べ替えができます。

Array.prototype.sort() - JavaScript | MDN

そうして並べ替えをした配列を、Array.join()で文字列化すれば良いでしょう。

Array.prototype.join() - JavaScript | MDN