Class ClockTriggerBuilder

ClockTriggerBuilder

Kreator aktywatorów zegara.

Metody

Metoda	Zwracany typ	Krótki opis
after(durationMilliseconds)	ClockTriggerBuilder	Określa minimalny czas (w milisekundach) po bieżącym czasie, po którym ma zostać uruchomiony wyzwalacz.
at(date)	ClockTriggerBuilder	Określa, kiedy wyzwalacz jest uruchamiany.
atDate(year, month, day)	ClockTriggerBuilder	Określa, że wyzwalacz zostanie uruchomiony w danym dniu, domyślnie około północy (±15 minut).
atHour(hour)	ClockTriggerBuilder	Określa godzinę, o której wyzwalacz jest uruchamiany.
create()	Trigger	Tworzy aktywator.
everyDays(n)	ClockTriggerBuilder	Określa, że wyzwalacz ma być uruchamiany co n dni.
everyHours(n)	ClockTriggerBuilder	Określa, że aktywator ma być uruchamiany co n godziny.
everyMinutes(n)	ClockTriggerBuilder	Określa, że reguła ma być uruchamiana co n minut.
everyWeeks(n)	ClockTriggerBuilder	Określa, że wyzwalacz ma być uruchamiany co n tygodni.
inTimezone(timezone)	ClockTriggerBuilder	Określa strefę czasową dla podanych dat i godzin, w których uruchamia się reguła.
nearMinute(minute)	ClockTriggerBuilder	Określa minutę, w której wyzwalacz jest uruchamiany (plus lub minus 15 minut).
onMonthDay(day)	ClockTriggerBuilder	Określa dzień miesiąca, w którym ma się uruchamiać wyzwalacz.
onWeekDay(day)	ClockTriggerBuilder	Określa dzień tygodnia, w którym wyzwalacz jest uruchamiany.

Szczegółowa dokumentacja

after(durationMilliseconds)

Określa minimalny czas (w milisekundach) po bieżącym czasie, po którym ma zostać uruchomiony wyzwalacz. Rzeczywisty czas trwania może się różnić, ale nie będzie krótszy niż określone minimum.

// 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, po którym ma zostać uruchomiony wyzwalacz.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

at(date)

Określa, kiedy wyzwalacz jest uruchamiany.

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

Parametry

Nazwa	Typ	Opis
date	Date	Obiekt Date reprezentujący czas, w którym aktywator powinien zostać uruchomiony.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

atDate(year, month, day)

Określa, że reguła zostanie uruchomiona w danym dniu, domyślnie około 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ć zaplanowane wywołanie (liczba z zakresu od 1 do 12 włącznie).
day	Integer	Dzień kalendarzowy, w którym ma zostać zaplanowane wywołanie (liczba z zakresu od 1 do 31, włącznie).

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

atHour(hour)

Określa godzinę, o której wyzwalacz jest uruchamiany.

// 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, o której ma się uruchomić.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

create()

Tworzy aktywator.

Powrót

Trigger – nowo utworzony zaplanowany aktywator.

---

everyDays(n)

Określa, że wyzwalacz ma być uruchamiany co n dni.

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

Parametry

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

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

everyHours(n)

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

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

Parametry

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

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

everyMinutes(n)

Określa, że reguła ma być uruchamiana co n minut. Wartość w polu 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 uruchomieniami.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

everyWeeks(n)

Określa, że wyzwalacz ma być uruchamiany 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 – narzędzie do tworzenia, do łączenia.

---

inTimezone(timezone)

Określa strefę czasową dla podanych dat i godzin, w których uruchamia się reguła. Domyślnie strefa czasowa jest taka sama jak w przypadku skryptu.

Lista prawidłowych ciągów tekstowych stref czasowych odpowiada liście prawidłowych ciągów tekstowych stref czasowych podanej na stronie Joda.org. Nieprawidłowy ciąg znaków strefy czasowej powoduje, że skrypt zgłasza 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, w której mają być traktowane informacje o czasie w zdarzeniu.

Powrót

ClockTriggerBuilder – ten ClockTriggerBuilder do tworzenia łańcuszków.

---

nearMinute(minute)

Określa minutę, w której wyzwalacz jest uruchamiany (plus lub minus 15 minut). Jeśli funkcja nearMinute() nie zostanie wywołana, użyta zostanie losowa wartość minuty.

// 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 ma się uruchomić.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

onMonthDay(day)

Określa dzień miesiąca, w którym ma się uruchamiać wyzwalacz.

// 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 ma być zaplanowana reguła.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.

---

onWeekDay(day)

Określa dzień tygodnia, w którym wyzwalacz jest uruchamiany.

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

Parametry

Nazwa	Typ	Opis
day	Weekday	Dzień tygodnia, w którym ma się uruchomić.

Powrót

ClockTriggerBuilder – narzędzie do tworzenia, do łączenia.