公開日：1日前最終更新日：11時間前

カレンダー予定のCSV漏れを保存前に発見｜GASでイベントをdry-run確認

Xでシェア facebookでシェア LINEでシェア

Gasおじ｜GoogleアカウントをAIエージェント化

先に知っておきたいこと
コピーして使える最小コード
実行手順
失敗しやすい点と停止条件
公開前チェックリスト
まとめ

Googleカレンダーの予定をCSVへ控えたいとき、期間や項目の指定が曖昧だと、必要な予定が抜けたり想定外の件数になったりします。この記事では、ファイルを作成する前にイベント件数とCSV予定行を確認する、無料のGAS例を紹介します。予定の作成・変更・削除やDriveへの保存は行いません。

先に知っておきたいこと

`DRY_RUN = true` を固定し、カレンダーとDriveを変更しません。
対象期間は最大31日、イベントは最大500件で停止します。
説明、参加者、会議URLは取得・出力しません。
終日予定と時刻付き予定を区別してCSV予定行を作ります。

コピーして使える最小コード

const DRY_RUN = true;
const CALENDAR_ID = 'primary';
const START_DATE = '2026-09-01';
const END_DATE = '2026-09-08';
const MAX_EVENTS = 500;

function auditCalendarEventExportCsvFree() {
  if (DRY_RUN !== true) throw new Error('安全のためDRY_RUN=trueで実行してください');
  const start = parseDate_(START_DATE);
  const end = parseDate_(END_DATE);
  if (end <= start) throw new Error('END_DATEはSTART_DATEより後にしてください');
  const days = (end - start) / 86400000;
  if (days > 31) throw new Error('対象期間は31日以内にしてください');
  if (MAX_EVENTS < 1 || MAX_EVENTS > 500) throw new Error('MAX_EVENTSは1〜500にしてください');

  const calendar = CalendarApp.getCalendarById(String(CALENDAR_ID).trim());
  if (!calendar) throw new Error('カレンダーを確認できません。IDと権限を見直してください');
  const events = calendar.getEvents(start, end);
  if (events.length > MAX_EVENTS) throw new Error('イベントが上限を超えました。期間を短くしてください');

  const rows = [['title', 'start', 'end', 'allDay']];
  events.forEach(event => rows.push([
    sanitizeCsv_(event.getTitle()),
    event.isAllDayEvent() ? formatDate_(event.getAllDayStartDate()) : event.getStartTime().toISOString(),
    event.isAllDayEvent() ? formatDate_(event.getAllDayEndDate()) : event.getEndTime().toISOString(),
    String(event.isAllDayEvent())
  ]));
  console.log(JSON.stringify({ dryRun: DRY_RUN, eventCount: events.length, sampleRows: rows.slice(0, 6) }));
}

function parseDate_(value) {
  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) throw new Error('日付はYYYY-MM-DDで入力してください');
  const date = new Date(value + 'T00:00:00');
  if (Number.isNaN(date.getTime())) throw new Error('日付を解釈できません');
  return date;
}

function formatDate_(date) {
  return Utilities.formatDate(date, Session.getScriptTimeZone(), 'yyyy-MM-dd');
}

function sanitizeCsv_(value) {
  const text = String(value || '').replace(/[\r\n]+/g, ' ').trim();
  return /^[=+\-@]/.test(text) ? "'" + text : text;
}