【GAS】nearMinute의 거동에 대해서

개요

nearMinute() 에 의해 시한식의 트리거를 설정하는 경우, 주의가 필요
5:00으로 설정하면 트리거가 실행되는 범위는 5:00~5:15, 5:45~5:59
5:55로 설정하면 트리거가 실행되는 범위는 5:00~5:10, 5:40~5:59

nearMinute(minute)

트리거가 실행되는 분을 지정합니다(±15분)
호출되지 않으면 무작위 분 값이 사용됩니다.

# 毎日 5:30 頃に実行される
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .atHour(5)
  .nearMinute(30)
  .everyDays(1)
  .create();

±15분 범위

시험적으로 실행 한 결과,이 범위에서 호출되었습니다.
nearMinute(0) 라고 지정했을 때, 45분~15분nearMinute(25) 라고 지정했을 때, 10분~40분nearMinute(50) 라고 지정했을 때, 35분~5분

※주의

.atHour(5).nearMinute(0)와 5:00에 트리거를 설정하면 5:00 ~ 5:15, 5:45 ~ 5:59 중 하나에서 실행됩니다.
4:45 ~ 5:15가 아님

실험

22:00 ~ 22:59까지 1분 단위로 트리거를 설정하고 실제로 실행 시작된 시간을 측정
(1 프로젝트 20 트리거까지를 위해 3 프로젝트로 나누어 실행)

측정 결과

.atHour()로 지정된 시간은 고정

.nearMinute() 로 지정한 분의 ±15분의 흔들림이 있다

시행 수가 적기 때문에 단언은 할 수 없지만 ± 8 분 정도는 맞는다

설정시간[A]
시작 시간[B]
[B] - [A]


22:00
22:02:54
0:02:54

22:01
22:04:05
0:03:05

22:02
22:08:26
0:06:26

22:03
22:57:49
0:54:49

22:04
22:59:45
0:55:45

22:05
22:04:54
-0:00:06

22:06
22:01:26
-0:04:34

22:07
22:05:53
-0:01:07

22:08
22:14:31
0:06:31

22:09
22:13:12
0:04:12

22:10
22:16:31
0:06:31

22:11
22:13:53
0:02:53

22:12
22:12:29
0:00:29

22:13
22:14:47
0:01:47

22:14
22:17:39
0:03:39

22:15
22:22:51
0:07:51

22:16
22:22:17
0:06:17

22:17
22:22:18
0:05:18

22:18
22:16:31
-0:01:29

22:19
22:13:37
-0:05:23

22:20
22:27:46
0:07:46

22:21
22:24:52
0:03:52

22:22
22:17:44
-0:04:16

22:23
22:25:32
0:02:32

22:24
22:24:00
0:00:00

22:25
22:27:33
0:02:33

22:26
22:23:50
-0:02:10

22:27
22:27:47
0:00:47

22:28
22:29:42
0:01:42

22:29
22:32:18
0:03:18

22:30
22:35:09
0:05:09

22:31
22:30:31
-0:00:29

22:32
22:31:40
-0:00:20

22:33
22:35:57
0:02:57

22:34
22:40:50
0:06:50

22:35
22:31:39
-0:03:21

22:36
22:41:40
0:05:40

22:37
22:37:37
0:00:37

22:38
22:33:10
-0:04:50

22:39
22:34:10
-0:04:50

22:40
22:37:27
-0:02:33

22:41
22:42:24
0:01:24

22:42
22:48:06
0:06:06

22:43
22:49:06
0:06:06

22:44
22:48:37
0:04:37

22:45
22:38:50
-0:06:10

22:46
22:50:51
0:04:51

22:47
22:44:53
-0:02:07

22:48
22:46:53
-0:01:07

22:49
22:47:19
-0:01:41

22:50
22:52:45
0:02:45

22:51
22:49:02
-0:01:58

22:52
22:54:58
0:02:58

22:53
22:46:57
-0:06:03

22:54
22:50:09
-0:03:51

22:55
22:01:19
-0:53:41

22:56
22:55:54
-0:00:06

22:57
22:54:32
-0:02:28

22:58
22:05:55
-0:52:05

22:59
22:59:43
0:00:43