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, przez jaki 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 ma on 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.