Googleカレンダーの空き時間を抽出する方法｜GASで複数人の共通スケジュールを管理

function findCommonFreeTime() {
  const sheetName = "空き時間確認"; // シート名を指定
  const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(sheetName);

  if (!sheet) {
    Logger.log(`Error: シート「${sheetName}」が見つかりません。スプレッドシートにシートを作成してください。`);
    return;
  }

  const startDate = new Date(sheet.getRange("B2").getValue()); // 開始日付
  const endDate = new Date(sheet.getRange("B3").getValue());   // 終了日付
  const interval = parseInt(sheet.getRange("B6").getValue());  // B6セルの時間間隔（分）

  if (isNaN(interval) || interval <= 0) {
    Logger.log("Error: B6セルに有効な時間間隔（分）を入力してください。");
    return;
  }

  const calendarIds = sheet.getRange("B1:1").getValues()[0].filter(id => id);

  if (calendarIds.length === 0) {
    Logger.log("Error: カレンダーIDが指定されていません。B1から右方向にカレンダーIDを入力してください。");
    return;
  }

  // B4とB5セルの値を取得して、対象時間を設定
  let startTimeStr = sheet.getRange("B4").getValue();
  let endTimeStr = sheet.getRange("B5").getValue();

  // B4, B5 がDate型の場合、文字列に変換
  if (startTimeStr instanceof Date) {
    startTimeStr = Utilities.formatDate(startTimeStr, Session.getScriptTimeZone(), "H:mm");
  }
  if (endTimeStr instanceof Date) {
    endTimeStr = Utilities.formatDate(endTimeStr, Session.getScriptTimeZone(), "H:mm");
  }
  
  let startHour = 0, startMinute = 0, endHour = 23, endMinute = 59;

  // B4（開始時間）が入力されている場合にその値を使用
  if (startTimeStr) {
    const [sHour, sMinute] = startTimeStr.split(":").map(Number);
    startHour = sHour;
    startMinute = sMinute || 0;
  }

  // B5（終了時間）が入力されている場合にその値を使用
  if (endTimeStr) {
    const [eHour, eMinute] = endTimeStr.split(":").map(Number);
    endHour = eHour;
    endMinute = eMinute || 0;
  }

  const weekdays = ["日", "月", "火", "水", "木", "金", "土"]; // 日本語の曜日
  const freeTimeSlots = [];

  for (let day = new Date(startDate); day <= endDate; day.setDate(day.getDate() + 1)) {
    const dayString = Utilities.formatDate(new Date(day), Session.getScriptTimeZone(), "yyyy/MM/dd");
    const weekdayString = `(${weekdays[day.getDay()]})`;
    const formattedDate = `${dayString} ${weekdayString}`;
    
    // 1日の開始・終了時刻
    const dayStart = new Date(day);
    dayStart.setHours(startHour, startMinute, 0, 0);
    const dayEnd = new Date(day);
    dayEnd.setHours(endHour, endMinute, 59, 999);
    
    let freeTimes = [{ start: new Date(dayStart), end: new Date(dayEnd) }];
    
    calendarIds.forEach(calendarId => {
      const calendar = CalendarApp.getCalendarById(calendarId);
      if (!calendar) {
        Logger.log(`Error: 指定されたカレンダーID「${calendarId}」が見つかりません。`);
        return;
      }

      const events = calendar.getEvents(dayStart, dayEnd);
      events.forEach(event => {
        const eventStart = event.getStartTime();
        const eventEnd = event.getEndTime();
        
        freeTimes = freeTimes.flatMap(time => {
          if (eventEnd <= time.start || eventStart >= time.end) {
            return [time];
          } else if (eventStart > time.start && eventEnd < time.end) {
            return [
              { start: time.start, end: eventStart },
              { start: eventEnd, end: time.end }
            ];
          } else if (eventStart <= time.start && eventEnd < time.end) {
            return [{ start: eventEnd, end: time.end }];
          } else if (eventStart > time.start && eventEnd >= time.end) {
            return [{ start: time.start, end: eventStart }];
          } else {
            return [];
          }
        });
      });
    });

    let currentStart = null;
    let currentEnd = null;

    freeTimes.forEach(time => {
      let startTime = new Date(time.start);
      while (startTime < time.end) {
        let endTime = new Date(startTime);
        endTime.setMinutes(endTime.getMinutes() + interval);
        if (endTime > time.end) endTime = time.end;

        const freeTimeDuration = (endTime - startTime) / (1000 * 60);
        if (freeTimeDuration >= interval) {
          if (currentStart === null) {
            currentStart = startTime;
          }
          currentEnd = endTime;
        } else {
          if (currentStart !== null) {
            const startStr = Utilities.formatDate(currentStart, Session.getScriptTimeZone(), "H:mm");
            const endStr = Utilities.formatDate(currentEnd, Session.getScriptTimeZone(), "H:mm");
            freeTimeSlots.push([formattedDate, `${startStr} - ${endStr}`]);
            currentStart = null;
            currentEnd = null;
          }
        }
        
        startTime = endTime;
      }
    });

    if (currentStart !== null) {
      const startStr = Utilities.formatDate(currentStart, Session.getScriptTimeZone(), "H:mm");
      const endStr = Utilities.formatDate(currentEnd, Session.getScriptTimeZone(), "H:mm");
      freeTimeSlots.push([formattedDate, `${startStr} - ${endStr}`]);
    }
  }

  sheet.getRange("A9:B").clear();
  
  if (freeTimeSlots.length === 0) {
    sheet.getRange("A9:B9").setValues([["空き時間が見つかりませんでした", ""]]);
  } else {
    const outputRange = sheet.getRange(9, 1, freeTimeSlots.length, 2);
    outputRange.setValues(freeTimeSlots);
  }

  const headerRange = sheet.getRange("A8:B8");
  headerRange.setValues([["日付", "空き時間"]]);
  headerRange.setHorizontalAlignment("center");
  headerRange.setBackground("#e6f4ea");

  const timeColumnRange = sheet.getRange(9, 2, freeTimeSlots.length, 1);
  timeColumnRange.setHorizontalAlignment("right");

  Logger.log(`${interval}分単位の共通の空き時間が出力されました。`);
}