Class ClockTriggerBuilder

ClockTriggerBuilder

Kreator wyzwalaczy zegara.

Metody

Metoda	Zwracany typ	Krótki opis
after(durationMilliseconds)	ClockTriggerBuilder	Określa minimalny czas trwania (w milisekundach) po bieżącym czasie uruchomienia reguły.
at(date)	ClockTriggerBuilder	Określa, kiedy uruchamiana jest reguła.
atDate(year, month, day)	ClockTriggerBuilder	Określa, że reguła uruchamia się danego dnia, domyślnie w pobliżu północy (+/- 15 minut).
atHour(hour)	ClockTriggerBuilder	Określa godzinę, o której uruchamia się aktywator.
create()	Trigger	Tworzy aktywator.
everyDays(n)	ClockTriggerBuilder	Określa, że reguła uruchamia się co n dni.
everyHours(n)	ClockTriggerBuilder	Określa, że reguła uruchamia się co n godzin.
everyMinutes(n)	ClockTriggerBuilder	Określa, że aktywator uruchamia się co n min.
everyWeeks(n)	ClockTriggerBuilder	Określa, że reguła uruchamia się co n tygodnie.
inTimezone(timezone)	ClockTriggerBuilder	Określa strefę czasową dla dat i godzin uruchomienia reguły.
nearMinute(minute)	ClockTriggerBuilder	Określa minutę, w której uruchamia się reguła (plus lub minus 15 minut).
onMonthDay(day)	ClockTriggerBuilder	Określa datę w miesiącu, w którym uruchomiono regułę.
onWeekDay(day)	ClockTriggerBuilder	Określa dzień tygodnia, w którym reguła jest uruchamiana.

Szczegółowa dokumentacja

after(durationMilliseconds)

Określa minimalny czas trwania (w milisekundach) po bieżącym czasie uruchomienia reguły. Rzeczywisty czas trwania może się różnić, ale nie będzie krótszy niż określona przez Ciebie wartość minimalna.

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .after(10 * 60 * 1000)
  .create();

Parametry

Nazwa	Typ	Opis
durationMilliseconds	Integer	Minimalny czas trwania (w milisekundach) po bieżącym czasie uruchamiania reguły.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

at(date)

Określa, kiedy uruchamiana jest reguła.

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

Parametry

Nazwa	Typ	Opis
date	Date	Obiekt daty określający, kiedy należy uruchomić aktywator.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

atDate(year, month, day)

Określa, że reguła uruchamia się danego dnia, domyślnie w pobliżu północy (+/- 15 minut).

// Schedules for January 1st, 2013
ScriptApp.newTrigger("myFunction")
  .timeBased()
  .atDate(2013, 1, 1)
  .create();

Parametry

Nazwa	Typ	Opis
year	Integer	Rok kalendarzowy, w którym ma zostać zaplanowany wyzwalacz.
month	Integer	Miesiąc kalendarzowy, w którym ma zostać zaplanowany wyzwalacz (powinien być liczbą z zakresu od 1 do 12 włącznie).
day	Integer	Dzień kalendarzowy, w którym ma zostać zaplanowany wyzwalacz (powinien to być liczba od 1 do 31 włącznie).

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

atHour(hour)

Określa godzinę, o której uruchamia się aktywator.

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

Parametry

Nazwa	Typ	Opis
hour	Integer	Godzina uruchomienia.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

create()

Tworzy aktywator.

Powroty

Trigger – nowo utworzony, zaplanowany wyzwalacz.

---

everyDays(n)

Określa, że reguła uruchamia się co n dni.

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

Parametry

Nazwa	Typ	Opis
n	Integer	Liczba dni między uruchomieniami.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

everyHours(n)

Określa, że reguła uruchamia się co n godzin.

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

Parametry

Nazwa	Typ	Opis
n	Integer	Liczba godzin między uruchomieniami.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

everyMinutes(n)

Określa, że aktywator uruchamia się co n min. n musi wynosić 1, 5, 10, 15 lub 30.

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

Parametry

Nazwa	Typ	Opis
n	Integer	Liczba minut między wykonaniami.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

everyWeeks(n)

Określa, że reguła uruchamia się co n tygodnie.

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

Parametry

Nazwa	Typ	Opis
n	Integer	Liczba tygodni między uruchomieniami.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

inTimezone(timezone)

Określa strefę czasową dla dat i godzin uruchomienia reguły. Domyślnie jest to strefa czasowa skryptu.

Lista prawidłowych ciągów stref czasowych odpowiada prawidłowym ciągom znaków strefy czasowej z listy Joda.org. Nieprawidłowy ciąg znaków dotyczący strefy czasowej powoduje, że skrypt generuje błąd.

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

Parametry

Nazwa	Typ	Opis
timezone	String	Strefa czasowa, z której mają być traktowane informacje o czasie w wydarzeniu.

Powroty

ClockTriggerBuilder – ten element typu ClockTriggerBuilder do tworzenia łańcuchów.

---

nearMinute(minute)

Określa minutę, w której uruchamia się reguła (plus lub minus 15 minut). Jeśli funkcja nearMinute() nie zostanie wywołana, używana jest losowa wartość minut.

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

Parametry

Nazwa	Typ	Opis
minute	Integer	Minuta, w której odpalono.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

onMonthDay(day)

Określa datę w miesiącu, w którym uruchomiono regułę.

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

Parametry

Nazwa	Typ	Opis
day	Integer	Dzień miesiąca, w którym należy zaplanować regułę.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.

---

onWeekDay(day)

Określa dzień tygodnia, w którym reguła jest uruchamiana.

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

Parametry

Nazwa	Typ	Opis
day	Weekday	Dzień tygodnia uruchomienia.

Powroty

ClockTriggerBuilder – kreator służący do tworzenia łańcuchów.