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분)을 지정합니다.
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분)을 지정합니다. 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 - 체이닝을 위한 빌더입니다.