Class ClockTriggerBuilder

ClockTriggerBuilder

시계 트리거용 빌더입니다.

메서드

메서드반환 유형간략한 설명
after(durationMilliseconds)ClockTriggerBuilder트리거가 실행되는 현재 시간 이후의 최소 지속 시간 (밀리초)을 지정합니다.
at(date)ClockTriggerBuilder트리거가 실행되는 시점을 지정합니다.
atDate(year, month, day)ClockTriggerBuilder기본적으로 자정 (+/- 15분) 무렵에 지정된 날짜에 트리거가 실행되도록 지정합니다.
atHour(hour)ClockTriggerBuilder트리거가 실행되는 시간을 지정합니다.
create()Trigger트리거를 만듭니다.
everyDays(n)ClockTriggerBuildern일마다 트리거를 실행하도록 지정합니다.
everyHours(n)ClockTriggerBuildern시간마다 트리거를 실행하도록 지정합니다.
everyMinutes(n)ClockTriggerBuildern분마다 트리거를 실행하도록 지정합니다.
everyWeeks(n)ClockTriggerBuildern주마다 트리거를 실행하도록 지정합니다.
inTimezone(timezone)ClockTriggerBuilder트리거가 실행될 때 지정된 날짜/시간의 시간대를 지정합니다.
nearMinute(minute)ClockTriggerBuilder트리거가 실행되는 분을 지정합니다 (15분 또는 - 15분).
onMonthDay(day)ClockTriggerBuilder트리거가 실행되는 월의 날짜를 지정합니다.
onWeekDay(day)ClockTriggerBuilder트리거가 실행되는 요일을 지정합니다.

자세한 문서

after(durationMilliseconds)

트리거가 실행되는 현재 시간 이후의 최소 지속 시간 (밀리초)을 지정합니다. 실제 기간은 다를 수 있지만 지정된 최솟값보다 짧지는 않습니다.

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .after(10 * 60 * 1000)
  .create();

매개변수

이름유형설명
durationMillisecondsInteger현재 시간 후 최소 지속 시간 (밀리초)입니다. 트리거가 실행되어야 합니다

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


at(date)

트리거가 실행되는 시점을 지정합니다.

// Creates a trigger for December 1, 2012
var triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .at(triggerDay)
  .create();

매개변수

이름유형설명
dateDate트리거 실행 시기를 나타내는 날짜 객체입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


atDate(year, month, day)

기본적으로 자정 (+/- 15분) 무렵에 지정된 날짜에 트리거가 실행되도록 지정합니다.

// Schedules for January 1st, 2013
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .atDate(2013, 1, 1)
  .create();

매개변수

이름유형설명
yearInteger트리거를 예약할 역년입니다.
monthInteger트리거를 예약할 달입니다. 1에서 12 사이의 숫자여야 합니다. 포함).
dayInteger트리거를 예약할 날짜입니다. 1에서 31 사이의 숫자여야 합니다. 포함).

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


atHour(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();

매개변수

이름유형설명
hourInteger실행할 시간입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


create()

트리거를 만듭니다.

리턴

Trigger - 새로 생성되어 예약된 트리거입니다.


everyDays(n)

n일마다 트리거를 실행하도록 지정합니다.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyDays(3)
  .create();

매개변수

이름유형설명
nInteger실행 사이의 일수입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


everyHours(n)

n시간마다 트리거를 실행하도록 지정합니다.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyHours(12)
  .create();

매개변수

이름유형설명
nInteger각 실행 사이의 시간입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


everyMinutes(n)

n분마다 트리거를 실행하도록 지정합니다. n는 1, 5, 10, 15 또는 30이어야 합니다.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyMinutes(10)
  .create();

매개변수

이름유형설명
nInteger실행 간격(분)입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


everyWeeks(n)

n주마다 트리거를 실행하도록 지정합니다.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyWeeks(2)
  .onWeekDay(ScriptApp.WeekDay.FRIDAY)
  .create();

매개변수

이름유형설명
nInteger실행 사이의 주 수입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


inTimezone(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();

매개변수

이름유형설명
timezoneString이벤트의 시간 정보를 처리하는 데 사용되는 시간대입니다.

리턴

ClockTriggerBuilder: 이 ClockTriggerBuilder는 체이닝을 위한 것입니다.


nearMinute(minute)

트리거가 실행되는 분을 지정합니다 (15분 또는 - 15분). nearMinute()가 호출되지 않으면 임의의 분 값이 사용됩니다.

// 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();

매개변수

이름유형설명
minuteInteger실행할 시간(분)입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


onMonthDay(day)

트리거가 실행되는 월의 날짜를 지정합니다.

// Schedules for the first of every month
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .onMonthDay(1)
  .create();

매개변수

이름유형설명
dayInteger트리거를 예약할 날짜입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.


onWeekDay(day)

트리거가 실행되는 요일을 지정합니다.

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .onWeekDay(ScriptApp.WeekDay.FRIDAY)
  .create();

매개변수

이름유형설명
dayWeekday실행할 요일입니다.

리턴

ClockTriggerBuilder - 체이닝을 위한 빌더입니다.