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분).
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
const triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();

매개변수

이름	유형	설명
date	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분). 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 - 연결을 위한 빌더입니다.