2
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【GAS】ScriptApp.at() の秒指定は意味がある?実際に検証してみた

2
Last updated at Posted at 2026-07-17

今までの記事一覧
Googleフォーム×GASで実現する業務自動化シリーズ全記事まとめ目次


プログラムを作っているとき、特定の時刻ぴったりに処理をしたいと思ったことはありませんか?私はときどきあります。
うちのAIちゃんに聞いたところ、このコードを教えてくれました。

function makeTrigger() {
  const triggers = ScriptApp.getProjectTriggers();

  //新しく「今日の11:00:00」に発動するトリガー作成
  let time = new Date();
  time.setHours(11);
  time.setMinutes(0);
  time.setSeconds(0);
  ScriptApp.newTrigger("実行したい関数名").timeBased().at(time).create();
}

これは、手動でトリガー設定をするときの「時間主導型」→「特定の日時」を作るものですね。

image

あれ?でもUIだと分単位までしか入れられないよ。GASでは秒まで入れられるの?

AIちゃん:
大丈夫。ぜったい秒まで入れたほうがいいよ。じゃないとバグるよ。それに、秒を入れないとノイズになるからお行儀よくないし(意訳)

ふぅ~ん、ちょっとググってみるか。

  ポチポチ・・・

秒まで入れてコードを書いてるページもあるけど、秒を入れても無意味って書いてるページもある。どっちやねん!

実験してみよう

トリガーで動かされるほうの関数

この3つの関数をトリガーで動かしてログを取ります。

function timeLog_second0() { //0秒設定で動かす関数
  Logger.log("0秒のトリガー:" + Utilities.formatDate(new Date(), "JST", "HH:mm:ss"));
}
function timeLog_second30() { //30秒設定で動かす関数
  Logger.log("30秒のトリガー:" + Utilities.formatDate(new Date(), "JST", "HH:mm:ss"));
}
function timeLog_second_none() {//秒を設定しないで動かす関数
  Logger.log("秒のトリガーなし:" + Utilities.formatDate(new Date(), "JST", "HH:mm:ss"));
}

トリガーを作成する関数

現在の時刻の1分後に時刻設定したトリガーを3つ作成し、それぞれ先ほどの関数を紐づけます。

  • 秒の指定なし:timeLog_second_none
  • 0秒に設定:timeLog_second0
  • 30秒に設定:timeLog_second30

こちらの関数でも、at() に渡す Dateオブジェクトの時刻をログに出力しておきます。

function makeTrigger_test() {
  const triggers = ScriptApp.getProjectTriggers();

  //それぞれのトリガーを取り出して、紐づいている関数名に「timeLog_second」が含まれていたら削除
  for (const trigger of triggers) {
    if (trigger.getHandlerFunction().includes("timeLog_second")) {
      ScriptApp.deleteTrigger(trigger);
    }
  }
  //現在時刻を時間・分・秒に分解
  let time = new Date();
  const hour = time.getHours();
  const minute = time.getMinutes() + 1;
  
  Logger.log("開始時間:" + Utilities.formatDate(new Date(), "JST", "HH:mm:ss"));

  //「現在の分+1」に発動するトリガー作成(秒なし)
  //timeLog_second_none を設定
  time.setHours(hour);
  time.setMinutes(minute);
  ScriptApp.newTrigger("timeLog_second_none").timeBased().at(time).create();
  Logger.log(" 秒なし設定:" + Utilities.formatDate(time, "JST", "HH:mm:ss"));

  //「現在の分+1 の0秒」に発動するトリガー作成
  //timeLog_second0 を設定
  time.setHours(hour);
  time.setMinutes(minute);
  time.setSeconds(0);
  ScriptApp.newTrigger("timeLog_second0").timeBased().at(time).create();
  Logger.log(" 0秒設定:" + Utilities.formatDate(time, "JST", "HH:mm:ss"));

  //「現在の分+1 の30秒」に発動するトリガー作成
  //timeLog_second30 を設定
  time.setHours(hour);
  time.setMinutes(minute);
  time.setSeconds(30);
  ScriptApp.newTrigger("timeLog_second30").timeBased().at(time).create();
  Logger.log(" 30秒設定:" + Utilities.formatDate(time, "JST", "HH:mm:ss"));

  Logger.log("終了時間:" + Utilities.formatDate(new Date(), "JST", "HH:mm:ss"));
}

変数 time には現在日時がミリ秒単位まで保持されています。そのため、秒を設定しない場合は現在時刻の秒がそのまま残ります。

実験結果

複数回実験した結果がこちらです。

image

結果を見ると、トリガー実行される側の3つの関数、実行順も実行された秒もばらばらです。これを見る限り、秒を指定してもあまり意味はないように見えます。

そしてもう1つ、不思議な挙動がありました。
14時24分に発動するはずの関数のうち、1つだけ25分にずれ込んでる!

image

このときに作成されたトリガー画面でも1つだけ時刻設定が25分になってる!

image

トリガー作成関数の実行が45秒と遅めだったため、Google側でトリガー作成に時間がかかり、24分の実行に間に合わなかったため、自動的に次の時刻へリスケされたのかもしれません。

0秒じゃなく59秒の設定にしたら?

もうひとつ試しに time.setSeconds(0); を time.setSeconds(59);(59秒)に変えて実行してみました。

image

なぜか無関係の「30秒」が1分ずれ込んでしまったものがありましたが、やはり秒の設定に相関関係はなさそうです。

現在の分にトリガー設定

さきほど59秒にしたものを0秒に戻し、トリガーを設定する関数のこの部分を

const minute = time.getMinutes() + 1;

このように変えて実験してみました。

const minute = time.getMinutes();//←←★

image
先ほどよりさらにタイトなスケジュールになったため、実行開始時間のリスケが多発しました。でもやはり実行順も実行された秒もバラバラで、秒の設定の相関関係は見られませんでした。

最後にためしに makeTrigger_test でのトリガー設定の順番を変えてみましたが、結果は同様でした。

まとめ

at() に渡す Date オブジェクトに秒まで設定することは可能です。しかし Trigger オブジェクトには予定実行時刻を取得するメソッドがないため、Googleが内部的に秒を保持しているかどうかの確認はできませんでした。

複数回検証しましたが、今回の実験では、設定した秒と実際の実行時刻との間に規則性は見つけられませんでした。少なくとも「0秒にしたから0秒付近で実行される」「30秒にしたから30秒付近になる」という挙動ではなさそうです。
Apps Script の時間トリガーは、秒単位でぴったり実行することを期待するものではなく、「指定した時刻付近で実行される」くらいに考えておくのが良さそうです。
また、トリガーを設定する処理の時刻とトリガーが発火する時刻の差が少ない場合はGoogleのほうで自動的にリスケする挙動も確認できました。

というわけなんだけど、AIちゃん、どう?

AIちゃん:
それでも誤作動やシステム側のズレを防ぐためにお作法として .setSeconds(0).setMilliseconds(0) で秒以下をクレンジングしたほうが絶対いいと思うよ!そうじゃないと「過去の時間」判定されてバグるかもだよ!(意訳)

ミリ秒まで!? それはないやろ・・・
少なくとも今回の実験では、その「お作法」の効果は確認できませんでした。
まあそういう負けず嫌いなところもかわいいけどね☆


image.png


この記事の内容はGoogleが公開している公式仕様ではなく、2026年7月時点で私が実機検証した結果と、そこから導き出した考察です。環境やアカウント種別によって挙動が異なる可能性はありますが、Apps Script の時間トリガーの挙動を考える際の、1つの参考になれば幸いです。

公式リファレンスでは、atDate() や nearMinute() には ±15 分程度の誤差があることが明記されています。一方、at() についてはそのような記載は見当たりません。
今回の検証でも ±15 分のような大きなずれは確認できず、発生した遅延は数秒〜1分程度でした。

2
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?