Конструктор триггеров для часов.
Методы
| Метод | Тип возврата | Краткое описание | 
|---|---|---|
| after(durationMilliseconds) | Clock Trigger Builder | Указывает минимальную продолжительность (в миллисекундах) после текущего времени срабатывания триггера. | 
| at(date) | Clock Trigger Builder | Указывает, когда срабатывает триггер. | 
| at Date(year, month, day) | Clock Trigger Builder | Указывает, что триггер срабатывает в указанную дату, по умолчанию около полуночи (+/- 15 минут). | 
| at Hour(hour) | Clock Trigger Builder | Указывает час, в который срабатывает триггер. | 
| create() | Trigger | Создает триггер. | 
| every Days(n) | Clock Trigger Builder | Указывает запускать триггер каждые nдней. | 
| every Hours(n) | Clock Trigger Builder | Указывает запускать триггер каждые nчасов. | 
| every Minutes(n) | Clock Trigger Builder | Указывает запуск триггера каждые nминут. | 
| every Weeks(n) | Clock Trigger Builder | Указывает запуск триггера каждые nнедель. | 
| in Timezone(timezone) | Clock Trigger Builder | Указывает часовой пояс для указанных дат/времени при запуске триггера. | 
| near Minute(minute) | Clock Trigger Builder | Указывает минуту срабатывания триггера (плюс-минус 15 минут). | 
| on Month Day(day) | Clock Trigger Builder | Указывает дату в месяце запуска триггера. | 
| on Week Day(day) | Clock Trigger Builder | Указывает день недели, в который запускается триггер. | 
Подробная документация
after(durationMilliseconds)
Указывает минимальную продолжительность (в миллисекундах) после текущего времени срабатывания триггера. Фактическая продолжительность может отличаться, но не будет меньше указанного вами минимума.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| duration Milliseconds | Integer | Минимальная продолжительность (в миллисекундах) после текущего времени, когда триггер должен сработать. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 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, указывающий, когда должен сработать триггер. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 at Date(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 включительно). | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 at Hour(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 | Час, в который нужно стрелять. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 create()
 every Days(n)
 Указывает запускать триггер каждые n дней.
ScriptApp .newTrigger('myFunction').timeBased().everyDays(3).create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| n | Integer | Количество дней между казнями. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 every Hours(n)
 Указывает запускать триггер каждые n часов.
ScriptApp .newTrigger('myFunction').timeBased().everyHours(12).create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| n | Integer | Количество часов между казнями. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 every Minutes(n)
 Указывает запуск триггера каждые n минут. n должно быть 1, 5, 10, 15 или 30.
ScriptApp .newTrigger('myFunction').timeBased().everyMinutes(10).create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| n | Integer | Количество минут между казнями. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 every Weeks(n)
 Указывает запуск триггера каждые n недель.
ScriptApp .newTrigger('myFunction') .timeBased() .everyWeeks(2) .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| n | Integer | Количество недель между казнями. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 in Timezone(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 | Часовой пояс, с помощью которого обрабатывается информация о времени в событии. | 
Возвращаться
 Clock Trigger Builder — это Clock Trigger Builder для создания цепочек. 
 near Minute(minute)
 Указывает минуту срабатывания триггера (плюс-минус 15 минут). Если near Minute() не вызывается, используется случайное значение минуты. 
// 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 | Минута, в которую нужно стрелять. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 on Month Day(day)
Указывает дату в месяце запуска триггера.
// Schedules for the first of every month ScriptApp.newTrigger('myFunction').timeBased().onMonthDay(1).create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| day | Integer | День месяца, на который должен быть запланирован триггер. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек. 
 on Week Day(day)
Указывает день недели, в который запускается триггер.
ScriptApp .newTrigger('myFunction') .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Параметры
| Имя | Тип | Описание | 
|---|---|---|
| day | Weekday | День недели для стрельбы. | 
Возвращаться
 Clock Trigger Builder — конструктор для создания цепочек.