Class ClockTriggerBuilder

ClockTriggerBuilder

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

메서드

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

매개변수

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

리턴

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

---

at(date)

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

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

매개변수

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

리턴

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

---

atDate(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 사이의 숫자여야 합니다. 포함).

리턴

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

매개변수

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

리턴

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

---

create()

트리거를 만듭니다.

리턴

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

---

everyDays(n)

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

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

매개변수

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

리턴

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

---

everyHours(n)

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

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

매개변수

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

리턴

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

---

everyMinutes(n)

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

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

매개변수

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

리턴

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

---

everyWeeks(n)

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

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

매개변수

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

리턴

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

매개변수

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

리턴

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

매개변수

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

리턴

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

---

onMonthDay(day)

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

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

매개변수

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

리턴

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

---

onWeekDay(day)

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

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

매개변수

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

리턴

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