시계 트리거의 빌더입니다.
메서드
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
after(durationMilliseconds) | Clock | 트리거가 실행되는 현재 시간 이후의 최소 기간 (밀리초)을 지정합니다. |
at(date) | Clock | 트리거가 실행되는 시점을 지정합니다. |
at | Clock | 지정된 날짜에 트리거가 실행되도록 지정합니다(기본적으로 자정(+/- 15분) 무렵). |
at | Clock | 트리거가 실행되는 시간을 지정합니다. |
create() | Trigger | 트리거를 만듭니다. |
every | Clock | 트리거를 n 일마다 실행하도록 지정합니다. |
every | Clock | 트리거를 n 시간마다 실행하도록 지정합니다. |
every | Clock | 트리거를 n 분마다 실행하도록 지정합니다. |
every | Clock | 트리거를 n 주마다 실행하도록 지정합니다. |
in | Clock | 트리거가 실행되는 지정된 날짜/시간의 시간대를 지정합니다. |
near | Clock | 트리거가 실행되는 분 (±15분)을 지정합니다. |
on | Clock | 트리거가 실행되는 월의 날짜를 지정합니다. |
on | Clock | 트리거가 실행되는 요일을 지정합니다. |
자세한 문서
after(durationMilliseconds)
트리거가 실행되는 현재 시간 이후의 최소 기간 (밀리초)을 지정합니다. 실제 기간은 다를 수 있지만 지정된 최솟값보다 짧지는 않습니다.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
duration | Integer | 트리거가 실행되어야 하는 현재 시간 이후의 최소 시간 (밀리초)입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
at(date)
트리거가 실행되는 시점을 지정합니다.
// Creates a trigger for December 1, 2012 const triggerDay = new Date(2012, 11, 1); ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
date | Date | 트리거가 실행되어야 하는 시점을 나타내는 Date 객체입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
at Date(year, month, day)
지정된 날짜에 트리거가 실행되도록 지정합니다(기본적으로 자정(+/- 15분) 무렵).
// Schedules for January 1st, 2013 ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 1, 1).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
year | Integer | 트리거를 예약할 연도입니다. |
month | Integer | 트리거를 예약할 달입니다 (1~12 사이의 숫자여야 함). |
day | Integer | 트리거를 예약할 캘린더 날짜입니다 (1~31 사이의 숫자여야 함). |
리턴
Clock
: 연결을 위한 빌더입니다.
at Hour(hour)
트리거가 실행되는 시간을 지정합니다.
// Runs between 5am-6am in the timezone of the script ScriptApp.newTrigger('myFunction') .timeBased() .atHour(5) .everyDays( 1) // Frequency is required if you are using atHour() or nearMinute() .create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
hour | Integer | 실행할 시간입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
create()
every Days(n)
트리거를 n
일마다 실행하도록 지정합니다.
ScriptApp .newTrigger('myFunction').timeBased().everyDays(3).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
n | Integer | 실행 간격 일 수입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
every Hours(n)
트리거를 n
시간마다 실행하도록 지정합니다.
ScriptApp .newTrigger('myFunction').timeBased().everyHours(12).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
n | Integer | 실행 간격 시간입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
every Minutes(n)
트리거를 n
분마다 실행하도록 지정합니다. n
는 1, 5, 10, 15 또는 30이어야 합니다.
ScriptApp .newTrigger('myFunction').timeBased().everyMinutes(10).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
n | Integer | 실행 간 경과 시간(분)입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
every Weeks(n)
트리거를 n
주마다 실행하도록 지정합니다.
ScriptApp .newTrigger('myFunction') .timeBased() .everyWeeks(2) .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
n | Integer | 실행 간격(주)입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
in Timezone(timezone)
트리거가 실행되는 지정된 날짜/시간의 시간대를 지정합니다. 기본적으로 시간대는 스크립트의 시간대입니다.
유효한 시간대 문자열 목록은 Joda.org에 나열된 유효한 시간대 문자열과 일치합니다. 잘못된 시간대 문자열은 스크립트에서 오류를 발생시킵니다.
// Schedule the trigger to execute at noon every day in the US/Pacific time zone ScriptApp.newTrigger('myFunction') .timeBased() .atHour(12) .everyDays(1) .inTimezone('America/Los_Angeles') .create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
timezone | String | 이벤트에서 시간 정보를 처리할 시간대입니다. |
리턴
Clock
— 체이닝을 위한 이 Clock
near Minute(minute)
트리거가 실행되는 분 (±15분)을 지정합니다. near
가 호출되지 않으면 임의의 분 값이 사용됩니다.
// Runs at approximately 5:30am in the timezone of the script ScriptApp.newTrigger('myFunction') .timeBased() .atHour(5) .nearMinute(30) .everyDays( 1) // Frequency is required if you are using atHour() or nearMinute() .create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
minute | Integer | 실행할 분입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
on Month Day(day)
트리거가 실행되는 월의 날짜를 지정합니다.
// Schedules for the first of every month ScriptApp.newTrigger('myFunction').timeBased().onMonthDay(1).create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
day | Integer | 트리거를 예약할 월의 날짜입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.
on Week Day(day)
트리거가 실행되는 요일을 지정합니다.
ScriptApp .newTrigger('myFunction') .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
매개변수
이름 | 유형 | 설명 |
---|---|---|
day | Weekday | 실행할 요일입니다. |
리턴
Clock
: 연결을 위한 빌더입니다.