Class ClockTriggerBuilder

ClockTriggerBuilder

Kreator wyzwalaczy zegara.

Metody

Metoda	Zwracany typ	Krótki opis
after(durationMilliseconds)	ClockTriggerBuilder	Określa minimalny czas (w milisekundach) od chwili uruchomienia reguły.
at(date)	ClockTriggerBuilder	Określa, kiedy ma być uruchamiana reguła.
atDate(year, month, day)	ClockTriggerBuilder	Określa, że reguła jest uruchamiana w danym dniu, domyślnie tuż po północy (+/- 15 minut).
atHour(hour)	ClockTriggerBuilder	Wskazuje godzinę uruchomienia reguły.
create()	Trigger	Tworzy regułę.
everyDays(n)	ClockTriggerBuilder	Określa, że reguła ma być uruchamiana co n dni.
everyHours(n)	ClockTriggerBuilder	Określa, że aktywator ma być uruchamiany co n godz.
everyMinutes(n)	ClockTriggerBuilder	Określa, że aktywator ma być uruchamiany co n min.
everyWeeks(n)	ClockTriggerBuilder	Określa, że reguła ma być uruchamiana co n tygodni.
inTimezone(timezone)	ClockTriggerBuilder	Określa strefę czasową dla określonych dat i godzin uruchamiania reguły.
nearMinute(minute)	ClockTriggerBuilder	Określa minutę uruchomienia reguły (plus lub minus 15 minut).
onMonthDay(day)	ClockTriggerBuilder	Określa dzień miesiąca, w którym reguła jest uruchamiana.
onWeekDay(day)	ClockTriggerBuilder	Określa dzień tygodnia, w którym uruchamia się reguła.

Szczegółowa dokumentacja

after(durationMilliseconds)

Określa minimalny czas (w milisekundach) od chwili uruchomienia reguły. Rzeczywisty czas może się różnić, ale nie będzie krótszy niż określona minimalna długość.

// 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 (w milisekundach) po bieżącym czasie, gdy należy uruchomić regułę.

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

at(date)

Określa, kiedy ma być uruchamiana 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 moment uruchomienia aktywatora.

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

atDate(year, month, day)

Określa, że reguła jest uruchamiana w danym dniu, domyślnie tuż po 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 zaplanowana jest reguła.
month	Integer	Miesiąc kalendarzowy, w którym zaplanowano regułę (powinien być liczbą od 1 do 12, włącznie).
day	Integer	Dzień kalendarzowy, w którym ma zostać zaplanowana reguła (powinien być liczbą od 1 do 31, włącznie).

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

atHour(hour)

Wskazuje godzinę uruchomienia reguły.

// 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.

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

create()

Tworzy regułę.

Powrót

Trigger – nowo utworzona, zaplanowana reguła.

---

everyDays(n)

Określa, że reguła ma być uruchamiana co n dni.

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

Parametry

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

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

everyHours(n)

Określa, że aktywator ma być uruchamiany co n godz.

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

Parametry

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

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

everyMinutes(n)

Określa, że aktywator ma być uruchamiany co n min. n musi mieć wartość 1, 5, 10, 15 lub 30.

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

Parametry

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

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

everyWeeks(n)

Określa, że reguła ma być uruchamiana co n tygodni.

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

Parametry

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

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

inTimezone(timezone)

Określa strefę czasową dla określonych dat i godzin uruchamiania reguły. Domyślnie atrybut zgodnie ze strefą czasową skryptu.

Lista prawidłowych ciągów stref czasowych odpowiada poprawnym ciągom znaków strefy czasowej wymienionym w Joda.org. Nieprawidłowy ciąg znaków strefy czasowej powoduje zgłoszenie błędu.

// 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órą mają być przetwarzane informacje o czasie w zdarzeniu.

Powrót

ClockTriggerBuilder – ClockTriggerBuilder do łańcuchów.

---

nearMinute(minute)

Określa minutę uruchomienia reguły (plus lub minus 15 minut). Jeśli funkcja nearMinute() nie jest wywoływana, 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 uruchomienia.

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

onMonthDay(day)

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

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

Parametry

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

Powrót

ClockTriggerBuilder – kreator łańcuchów.

---

onWeekDay(day)

Określa dzień tygodnia, w którym uruchamia się reguła.

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

Parametry

Nazwa	Typ	Opis
day	Weekday	Dzień tygodnia uruchomienia.

Powrót

ClockTriggerBuilder – kreator łańcuchów.