Class ClockTriggerBuilder

ClockTriggerBuilder

Kreator wyzwalaczy zegara.

Metody

MetodaZwracany typKrótki opis
after(durationMilliseconds)ClockTriggerBuilderOkreśla minimalny czas (w milisekundach) od chwili uruchomienia reguły.
at(date)ClockTriggerBuilderOkreśla, kiedy ma być uruchamiana reguła.
atDate(year, month, day)ClockTriggerBuilderOkreśla, że reguła jest uruchamiana w danym dniu, domyślnie tuż po północy (+/- 15 minut).
atHour(hour)ClockTriggerBuilderWskazuje godzinę uruchomienia reguły.
create()TriggerTworzy regułę.
everyDays(n)ClockTriggerBuilderOkreśla, że reguła ma być uruchamiana co n dni.
everyHours(n)ClockTriggerBuilderOkreśla, że aktywator ma być uruchamiany co n godz.
everyMinutes(n)ClockTriggerBuilderOkreśla, że aktywator ma być uruchamiany co n min.
everyWeeks(n)ClockTriggerBuilderOkreśla, że reguła ma być uruchamiana co n tygodni.
inTimezone(timezone)ClockTriggerBuilderOkreśla strefę czasową dla określonych dat i godzin uruchamiania reguły.
nearMinute(minute)ClockTriggerBuilderOkreśla minutę uruchomienia reguły (plus lub minus 15 minut).
onMonthDay(day)ClockTriggerBuilderOkreśla dzień miesiąca, w którym reguła jest uruchamiana.
onWeekDay(day)ClockTriggerBuilderOkreś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

NazwaTypOpis
durationMillisecondsIntegerMinimalny 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

NazwaTypOpis
dateDateObiekt 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

NazwaTypOpis
yearIntegerRok kalendarzowy, w którym zaplanowana jest reguła.
monthIntegerMiesiąc kalendarzowy, w którym zaplanowano regułę (powinien być liczbą od 1 do 12, włącznie).
dayIntegerDzień 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

NazwaTypOpis
hourIntegerGodzina 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

NazwaTypOpis
nIntegerLiczba 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

NazwaTypOpis
nIntegerLiczba 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

NazwaTypOpis
nIntegerLiczba 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

NazwaTypOpis
nIntegerLiczba 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

NazwaTypOpis
timezoneStringStrefa czasowa, z którą mają być przetwarzane informacje o czasie w zdarzeniu.

Powrót

ClockTriggerBuilderClockTriggerBuilder 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

NazwaTypOpis
minuteIntegerMinuta 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

NazwaTypOpis
dayIntegerDzień 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

NazwaTypOpis
dayWeekdayDzień tygodnia uruchomienia.

Powrót

ClockTriggerBuilder – kreator łańcuchów.