
Googleカレンダーから稼働時間を自動集計するGAS|案件別の稼働表・月次報告書・請求明細PDFをGmail下書きまで(コピペ用テンプレート)
「月末になると、カレンダーを1日ずつさかのぼって、稼働時間を数えている」
「案件ごとに分けて、時給をかけて、報告書を作るだけで1〜2時間かかる」
副業やフリーランスのエンジニア、業務委託で時間単価の仕事をしていると、月末にこの作業がやってきます。
・Googleカレンダーに作業の予定を入れているのに、集計は手で電卓
・案件が2つ3つあると、どの予定がどの案件か、見分けるのに時間がかかる
・会議と作業が重なっている日、日付をまたいだ夜間作業の数え方に毎回迷う
・15分単位・30分単位の丸めや、税込・税抜の計算をまちがえないか不安
・稼働報告書と請求の明細を、毎月ほぼ同じ形で作り直している
この記事は、その月末の作業を、Googleカレンダー・スプレッドシート・GAS(Google Apps Script)で自動にするテンプレートです。
読むとできること:カレンダーの予定から、稼働表と報告書の下書きまで
予定のタイトルを「【案件名】作業内容」のように書いておくだけで、あとはボタン1つ(または毎月1日の自動実行)で、次のところまで進みます。
・予定を案件ごとに判定(タイトルの【案件名】・キーワード・予定の色)
・終日の予定、辞退した会議、「非稼働」「移動」などの予定は数えない
・重なった時間は二重に数えず、警告を出す。日をまたぐ予定は日付ごとに分ける
・15分/30分単位で丸め、「案件別・日別」「月別」の稼働表を作る
・案件ごとの合計・時給×時間・消費税を並べた「月次報告書」を作る
・請求先ごとに報告書をPDFにして、Gmailの「下書き」に添付する(送信はしない)
案件が判定できなかった予定は「未分類」シートに出るので、案件名を入れて再集計すれば反映されます。

無料で出回っている情報との違い
「GAS カレンダー 集計」で調べると、予定の時間を足し合わせるだけの短いコードは無料でも見つかります。1つの案件だけなら、それで足りることもあります。ただ、毎月の請求に使うとなると、困るのは「足し算」より、その前後の細かいところです。このテンプレートは、そこを最初から入れています。
案件の判定をシートで決める:「案件ルール」シートに、案件名・判定のしかた(括弧/キーワード/色)・時給・請求先・送付先を書くだけ。コードは触りません
数えない予定を決めてある:終日の予定・辞退した予定・不在の予定・非稼働キーワードは除外し、明細に「なぜ除外したか」を残します
重なりと日またぎ:同じ時間に入っている予定は、あとの予定から重なった分を引いて警告列に書きます。23時〜翌2時のような予定は日付ごとに分け、月をまたぐ分は翌月に回します
何度実行しても増えない:予定のID+開始時刻をキーにして上書きします。予定を直してから再集計しても、行が二重になりません。手で書いたメモ欄は残ります
丸めと端数の選択:丸めは15分/30分/なし、切り捨て・四捨五入・切り上げ、「予定ごと/日ごと/月ごと」から選べます。金額の1円未満の扱い、時給が税込か税抜か、消費税を出すかどうかも設定で決めます
送らない・二重に作らない:作るのはGmailの下書きだけ。最初はテストモードで、下書きの宛先は自分になります。同じ月・同じ案件の下書きは二重に作りません
止まり方を決めてある:GASの1回6分の制限に合わせて、上限の秒数を超えたら途中で止め、次の実行で続きから作ります
コードはNode.jsで、カレンダー・スプレッドシート・Gmailをまねした環境を作り、98項目のテスト(案件判定、丸め、重なりの控除、除外、月の境目、請求額の端数処理、再実行で重複しないこと、下書きなど)を通してあります。Googleの実際の環境ではまだ動かしていないので、設置したら最初にテストモードで確かめてください(手順は有料部分に書いています)。
こんな方に向いています
・Googleカレンダーに作業時間を入れている、副業・フリーランスのエンジニアや業務委託の方
・時給(時間単価)で請求していて、毎月、稼働報告書を出している方
・案件が複数あって、月末の集計と報告書づくりに時間をとられている方
向いていない方
・Googleカレンダーに作業の予定を入れていない方(先に予定を入れる習慣が必要です)
・固定額・成果物ごとの請求で、時間を数える必要がない方
・会社の勤怠システムに入力する決まりがある方(このテンプレートは勤怠システムとはつながりません)
有料部分に入っているもの
・コード全文(コピーして貼るだけ。約690行・コメントは日本語)
・「設定」「案件ルール」シートの書き方(記入例つき)と、予定タイトルの書き方のコツ
・テストモードでの確かめ方、未分類の直し方、重なり警告の見方
・月次報告書・PDF・Gmail下書きの作り方と、本番への切りかえ方
・毎月1日の自動実行の設定と、毎月の流れ
・任意:Gemini APIで「作業内容のコメント」を下書きする方法(既定はオフ)
・よくあるつまずきQ&A、カスタマイズ例、請求・税の扱いの注意
ほかのテンプレートは、悩み別のカタログにまとめています。自分に合う記事を探すときに使ってください。
ここから有料(980円)