이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class 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: 연결을 위한 빌더입니다.