Class ClockTriggerBuilder

ClockTriggerBuilder

Ein Builder für Uhrzeittrigger.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
after(durationMilliseconds)	ClockTriggerBuilder	Gibt die Mindestdauer in Millisekunden nach der aktuellen Zeit an, nach der der Trigger ausgeführt wird.
at(date)	ClockTriggerBuilder	Gibt an, wann der Trigger ausgeführt wird.
atDate(year, month, day)	ClockTriggerBuilder	Gibt an, dass der Trigger am angegebenen Datum ausgelöst wird, standardmäßig gegen Mitternacht (+/- 15 Minuten).
atHour(hour)	ClockTriggerBuilder	Gibt die Stunde an, zu der der Trigger ausgeführt wird.
create()	Trigger	Erstellt den Trigger.
everyDays(n)	ClockTriggerBuilder	Gibt an, dass der Trigger alle n Tage ausgeführt werden soll.
everyHours(n)	ClockTriggerBuilder	Gibt an, dass der Trigger alle n Stunden ausgeführt werden soll.
everyMinutes(n)	ClockTriggerBuilder	Gibt an, dass der Trigger alle n Minuten ausgeführt werden soll.
everyWeeks(n)	ClockTriggerBuilder	Gibt an, dass der Trigger alle n Wochen ausgeführt werden soll.
inTimezone(timezone)	ClockTriggerBuilder	Gibt die Zeitzone für die angegebenen Datums-/Uhrzeitangaben an, zu denen der Trigger ausgeführt wird.
nearMinute(minute)	ClockTriggerBuilder	Gibt die Minute an, in der der Trigger ausgeführt wird (plus oder minus 15 Minuten).
onMonthDay(day)	ClockTriggerBuilder	Gibt das Datum im Monat an, an dem der Trigger ausgeführt wird.
onWeekDay(day)	ClockTriggerBuilder	Gibt den Wochentag an, an dem der Trigger ausgeführt wird.

Detaillierte Dokumentation

after(durationMilliseconds)

Gibt die Mindestdauer in Millisekunden nach der aktuellen Zeit an, nach der der Trigger ausgeführt wird. Die tatsächliche Dauer kann variieren, darf aber nicht unter dem angegebenen Mindestwert liegen.

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();

Parameter

Name	Typ	Beschreibung
durationMilliseconds	Integer	Die Mindestdauer (in Millisekunden) nach der aktuellen Zeit, nach der der Trigger ausgeführt werden soll.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

at(date)

Gibt an, wann der Trigger ausgeführt wird.

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

Parameter

Name	Typ	Beschreibung
date	Date	Ein Date-Objekt, das angibt, wann der Trigger ausgeführt werden soll.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

atDate(year, month, day)

Gibt an, dass der Trigger am angegebenen Datum ausgelöst wird, standardmäßig gegen Mitternacht (+/- 15 Minuten).

// Schedules for January 1st, 2013
ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 1, 1).create();

Parameter

Name	Typ	Beschreibung
year	Integer	Das Kalenderjahr, in dem der Trigger geplant werden soll.
month	Integer	Der Kalendermonat, in dem der Trigger ausgelöst werden soll (muss eine Zahl zwischen 1 und 12 sein, einschließlich).
day	Integer	Der Kalendertag, an dem der Trigger ausgelöst werden soll (muss eine Zahl zwischen 1 und 31 sein, einschließlich).

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

atHour(hour)

Gibt die Stunde an, zu der der Trigger ausgeführt wird.

// 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();

Parameter

Name	Typ	Beschreibung
hour	Integer	Die Stunde, zu der die Benachrichtigung gesendet werden soll.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

create()

Erstellt den Trigger.

Rückflug

Trigger: Der neu erstellte geplante Trigger.

---

everyDays(n)

Gibt an, dass der Trigger alle n Tage ausgeführt werden soll.

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

Parameter

Name	Typ	Beschreibung
n	Integer	Die Anzahl der Tage zwischen den Ausführungen.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

everyHours(n)

Gibt an, dass der Trigger alle n Stunden ausgeführt werden soll.

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

Parameter

Name	Typ	Beschreibung
n	Integer	Die Anzahl der Stunden zwischen den Ausführungen.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

everyMinutes(n)

Gibt an, dass der Trigger alle n Minuten ausgeführt werden soll. n muss 1, 5, 10, 15 oder 30 sein.

ScriptApp.newTrigger('myFunction').timeBased().everyMinutes(10).create();

Parameter

Name	Typ	Beschreibung
n	Integer	Die Anzahl der Minuten zwischen den Ausführungen.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

everyWeeks(n)

Gibt an, dass der Trigger alle n Wochen ausgeführt werden soll.

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

Parameter

Name	Typ	Beschreibung
n	Integer	Die Anzahl der Wochen zwischen den Ausführungen.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

inTimezone(timezone)

Gibt die Zeitzone für die angegebenen Datums-/Uhrzeitangaben an, zu denen der Trigger ausgeführt wird. Standardmäßig wird die Zeitzone des Skripts verwendet.

Die Liste der gültigen Zeitzonenstrings entspricht den gültigen Zeitzonenstrings, die von Joda.org aufgeführt werden. Ein ungültiger Zeitzonenstring führt dazu, dass das Skript einen Fehler ausgibt.

// 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();

Parameter

Name	Typ	Beschreibung
timezone	String	Die Zeitzone, in der Zeitinformationen im Ereignis behandelt werden sollen.

Rückflug

ClockTriggerBuilder – Diese ClockTriggerBuilder zur Verkettung.

---

nearMinute(minute)

Gibt die Minute an, in der der Trigger ausgeführt wird (plus oder minus 15 Minuten). Wenn nearMinute() nicht aufgerufen wird, wird ein zufälliger Minutenwert verwendet.

// 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();

Parameter

Name	Typ	Beschreibung
minute	Integer	Die Minute, in der das Ereignis ausgelöst werden soll.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

onMonthDay(day)

Gibt das Datum im Monat an, an dem der Trigger ausgeführt wird.

// Schedules for the first of every month
ScriptApp.newTrigger('myFunction').timeBased().onMonthDay(1).create();

Parameter

Name	Typ	Beschreibung
day	Integer	Der Tag des Monats, für den der Trigger geplant werden soll.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.

---

onWeekDay(day)

Gibt den Wochentag an, an dem der Trigger ausgeführt wird.

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

Parameter

Name	Typ	Beschreibung
day	Weekday	Der Wochentag, an dem die Aktion ausgelöst werden soll.

Rückflug

ClockTriggerBuilder – Der Builder zur Verkettung.