Class ClockTriggerBuilder

ClockTriggerBuilder

Un generatore per i trigger a tempo.

Metodi

Metodo	Tipo restituito	Breve descrizione
after(durationMilliseconds)	ClockTriggerBuilder	Specifica la durata minima (in millisecondi) dopo l'ora corrente in cui viene eseguato il trigger.
at(date)	ClockTriggerBuilder	Specifica quando viene eseguito l'attivatore.
atDate(year, month, day)	ClockTriggerBuilder	Specifica che il trigger viene attivato nella data indicata, per impostazione predefinita verso mezzanotte (+/- 15 minuti).
atHour(hour)	ClockTriggerBuilder	Specifica l'ora in cui viene eseguito l'attivatore.
create()	Trigger	Crea il trigger.
everyDays(n)	ClockTriggerBuilder	Specifica di eseguire il trigger ogni n giorni.
everyHours(n)	ClockTriggerBuilder	Specifica di eseguire il trigger ogni n ore.
everyMinutes(n)	ClockTriggerBuilder	Specifica di eseguire il trigger ogni n minuti.
everyWeeks(n)	ClockTriggerBuilder	Specifica di eseguire il trigger ogni n settimane.
inTimezone(timezone)	ClockTriggerBuilder	Specifica il fuso orario per le date/ore specificate in cui viene eseguito il trigger.
nearMinute(minute)	ClockTriggerBuilder	Specifica il minuto in cui viene eseguito il trigger (più o meno 15 minuti).
onMonthDay(day)	ClockTriggerBuilder	Specifica la data del mese in cui viene eseguito il trigger.
onWeekDay(day)	ClockTriggerBuilder	Specifica il giorno della settimana in cui viene eseguito il trigger.

Documentazione dettagliata

after(durationMilliseconds)

Specifica la durata minima (in millisecondi) dopo l'ora corrente in cui viene eseguato il trigger. La durata effettiva può variare, ma non sarà inferiore al minimo specificato.

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

Parametri

Nome	Tipo	Descrizione
durationMilliseconds	Integer	La durata minima (in millisecondi) dopo l'ora corrente in cui deve essere eseguito il trigger.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

at(date)

Specifica quando viene eseguito l'attivatore.

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

Parametri

Nome	Tipo	Descrizione
date	Date	Un oggetto Date che rappresenta il momento in cui deve essere eseguito il trigger.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

atDate(year, month, day)

Specifica che il trigger viene attivato nella data indicata, per impostazione predefinita verso mezzanotte (+/- 15 minuti).

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

Parametri

Nome	Tipo	Descrizione
year	Integer	L'anno solare in cui pianificare il trigger.
month	Integer	Il mese di calendario in cui pianificare l'attivazione (deve essere un numero compreso tra 1 e 12, inclusi).
day	Integer	Il giorno del calendario in cui pianificare il trigger (deve essere un numero compreso tra 1 e 31, incluso).

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

atHour(hour)

Specifica l'ora in cui viene eseguito l'attivatore.

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

Parametri

Nome	Tipo	Descrizione
hour	Integer	L'ora in cui attivare la notifica.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

create()

Crea il trigger.

Indietro

Trigger: il trigger pianificato appena creato.

---

everyDays(n)

Specifica di eseguire il trigger ogni n giorni.

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

Parametri

Nome	Tipo	Descrizione
n	Integer	Il numero di giorni tra le esecuzioni.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

everyHours(n)

Specifica di eseguire il trigger ogni n ore.

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

Parametri

Nome	Tipo	Descrizione
n	Integer	Il numero di ore tra le esecuzioni.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

everyMinutes(n)

Specifica di eseguire il trigger ogni n minuti. n deve essere 1, 5, 10, 15 o 30.

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

Parametri

Nome	Tipo	Descrizione
n	Integer	Il numero di minuti tra le esecuzioni.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

everyWeeks(n)

Specifica di eseguire il trigger ogni n settimane.

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

Parametri

Nome	Tipo	Descrizione
n	Integer	Il numero di settimane tra le esecuzioni.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

inTimezone(timezone)

Specifica il fuso orario per le date/ore specificate in cui viene eseguito il trigger. Per impostazione predefinita, il fuso orario è quello dello script.

L'elenco delle stringhe del fuso orario valide corrisponde a quelle elencate da Joda.org. Una stringa del fuso orario non valida fa sì che lo script generi un errore.

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

Parametri

Nome	Tipo	Descrizione
timezone	String	Il fuso orario con cui trattare le informazioni sull'ora nell'evento.

Indietro

ClockTriggerBuilder: questo ClockTriggerBuilder, per il concatenamento.

---

nearMinute(minute)

Specifica il minuto in cui viene eseguito il trigger (più o meno 15 minuti). Se nearMinute() non viene chiamato, viene utilizzato un valore di minuti casuale.

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

Parametri

Nome	Tipo	Descrizione
minute	Integer	Il minuto in cui attivare il trigger.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

onMonthDay(day)

Specifica la data del mese in cui viene eseguito il trigger.

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

Parametri

Nome	Tipo	Descrizione
day	Integer	Il giorno del mese in cui deve essere pianificato l'attivatore.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.

---

onWeekDay(day)

Specifica il giorno della settimana in cui viene eseguito il trigger.

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

Parametri

Nome	Tipo	Descrizione
day	Weekday	Il giorno della settimana in cui attivare l'evento.

Indietro

ClockTriggerBuilder: il builder per il concatenamento.