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()
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.