Kreator aktywatorów zegarowych.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
after(durationMilliseconds) | Clock | Określa minimalny czas (w milisekundach) po bieżącym czasie, przez jaki ma działać reguła. |
at(date) | Clock | Określa, kiedy ma być uruchamiany. |
at | Clock | Określa, że reguła jest uruchamiany w określonym dniu, domyślnie w pobliżu północy (+/- 15 minut). |
at | Clock | Określa godzinę, o której ma działać. |
create() | Trigger | Tworzy aktywator. |
every | Clock | Określa, że wyzwalacz ma być uruchamiany co n dni. |
every | Clock | Określa, że matryca ma być uruchamiana co n godzin. |
every | Clock | Określa, że reguła ma być uruchamiana co n minut. |
every | Clock | Określa, że ma on być uruchamiany co n tygodni. |
in | Clock | Określa strefę czasową dla określonych dat/godzin, w których ma działać reguła. |
near | Clock | Określa minutę, o której ma być uruchamiany (z dokładnością do 15 minut). |
on | Clock | Określa datę w miesiącu, w którym ma być uruchamiany. |
on | Clock | Określa dzień tygodnia, w którym ma być wykonywany. |
Szczegółowa dokumentacja
after(durationMilliseconds)
Określa minimalny czas (w milisekundach) po bieżącym czasie, w którym ma działać reguła. Rzeczywisty czas może się różnić, ale nie będzie krótszy niż określony przez Ciebie minimalny czas.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();
Parametry
Nazwa | Typ | Opis |
---|---|---|
duration | Integer | Minimalny czas (w milisekundach) od bieżącego czasu, w którym ma być wykonywany. |
Powrót
Clock
– kreator do łańcuchowania.
at(date)
Określa, kiedy ma być 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 określający, kiedy ma działać reguła. |
Powrót
Clock
– kreator do łańcuchowania.
at Date(year, month, day)
Określa, że reguła jest uruchamiany w określonym dniu, 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 być zaplanowany reguła. |
month | Integer | Miesiąc kalendarzowy, w którym ma być zaplanowany reguła (powinna to być liczba z zakresu 1–12). |
day | Integer | Dzień kalendarzowy, w którym ma być zaplanowany reguła (powinna to być liczba z zakresu od 1 do 31). |
Powrót
Clock
– kreator do łańcuchowania.
at Hour(hour)
Określa godzinę, o której ma działać.
// 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
Clock
– kreator do łańcuchowania.
create()
every Days(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 wykonaniem. |
Powrót
Clock
– kreator do łańcuchowania.
every Hours(n)
Określa, że matryca ma być uruchamiana co n
godzin.
ScriptApp.newTrigger('myFunction').timeBased().everyHours(12).create();
Parametry
Nazwa | Typ | Opis |
---|---|---|
n | Integer | Liczba godzin między wykonaniami. |
Powrót
Clock
– kreator do łańcuchowania.
every Minutes(n)
Określa, że reguła ma być uruchamiana co n
minut. Wartość w polu n
musi być równa 1, 5, 10, 15 lub 30.
ScriptApp.newTrigger('myFunction').timeBased().everyMinutes(10).create();
Parametry
Nazwa | Typ | Opis |
---|---|---|
n | Integer | Liczba minut między wykonaniami. |
Powrót
Clock
– kreator do łańcuchowania.
every Weeks(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 wykonaniem. |
Powrót
Clock
– kreator do łańcuchowania.
in Timezone(timezone)
Określa strefę czasową dla określonych dat/godzin, w których ma działać reguła. Domyślnie strefa czasowa to ta, w której znajduje się skrypt.
Lista prawidłowych ciągów tekstowych stref czasowych odpowiada prawidłowym ciągom tekstowym stref czasowych wymienionym na stronie Joda.org. Nieprawidłowy ciąg znaków strefy czasowej powoduje błąd skryptu.
// 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ć interpretowane informacje o czasie w zdarzeniu. |
Powrót
Clock
– ta Clock
służy do tworzenia łańcuszków.
near Minute(minute)
Określa minutę, o której ma być uruchamiany (z dokładnością do 15 minut). Jeśli funkcja near
nie zostanie wywołana, zostanie użyta 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 ma nastąpić działanie. |
Powrót
Clock
– kreator do łańcuchowania.
on Month Day(day)
Określa datę w miesiącu, w którym ma być uruchamiany.
// 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
Clock
– kreator do łańcuchowania.
on Week Day(day)
Określa dzień tygodnia, w którym ma być wykonywany.
ScriptApp.newTrigger('myFunction') .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Parametry
Nazwa | Typ | Opis |
---|---|---|
day | Weekday | Dzień tygodnia, w którym ma być wykonywane. |
Powrót
Clock
– kreator do łańcuchowania.