Un generatore di trigger orologio.
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
after(durationMilliseconds) | ClockTriggerBuilder | Specifica la durata minima (in millisecondi) dopo l'ora attuale di esecuzione dell'attivatore. |
at(date) | ClockTriggerBuilder | Specifica quando viene eseguito il trigger. |
atDate(year, month, day) | ClockTriggerBuilder | Specifica che l'attivatore si attiva nella data specificata, per impostazione predefinita vicino a mezzanotte (+/- 15 minuti). |
atHour(hour) | ClockTriggerBuilder | Specifica l'ora di esecuzione dell'attivatore. |
create() | Trigger | Crea l'attivatore. |
everyDays(n) | ClockTriggerBuilder | Specifica di eseguire l'attivatore ogni n giorni. |
everyHours(n) | ClockTriggerBuilder | Specifica di eseguire il trigger ogni n ore. |
everyMinutes(n) | ClockTriggerBuilder | Specifica di eseguire l'attivatore ogni n minuti. |
everyWeeks(n) | ClockTriggerBuilder | Specifica di eseguire l'attivatore ogni n settimane. |
inTimezone(timezone) | ClockTriggerBuilder | Specifica il fuso orario per le date/ore specificate quando viene eseguito l'attivatore. |
nearMinute(minute) | ClockTriggerBuilder | Specifica il minuto di esecuzione del trigger (più o meno 15 minuti). |
onMonthDay(day) | ClockTriggerBuilder | Specifica la data del mese in cui viene eseguito l'attivatore. |
onWeekDay(day) | ClockTriggerBuilder | Specifica il giorno della settimana in cui viene eseguito l'attivatore. |
Documentazione dettagliata
after(durationMilliseconds)
Specifica la durata minima (in millisecondi) dopo l'ora attuale di esecuzione dell'attivatore. La durata effettiva può variare, ma non sarà inferiore al valore 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 attuale in cui deve essere eseguito il trigger. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
at(date)
Specifica quando viene eseguito il trigger.
// Creates a trigger for December 1, 2012
var triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger("myFunction")
.timeBased()
.at(triggerDay)
.create();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
date | Date | Un oggetto Data che rappresenta il momento in cui deve essere eseguito l'attivatore. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
atDate(year, month, day)
Specifica che l'attivatore si attiva nella data specificata, per impostazione predefinita vicino a 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 di calendario per cui pianificare l'attivatore. |
month | Integer | Il mese di calendario in cui pianificare l'attivatore (deve essere un numero compreso tra 1 e 12 inclusi). |
day | Integer | Il giorno di calendario per pianificare l'attivatore (deve essere un numero compreso tra 1 e 31 inclusi). |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
atHour(hour)
Specifica l'ora di esecuzione dell'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 sparare. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
create()
everyDays(n)
Specifica di eseguire l'attivatore ogni n giorni.
ScriptApp.newTrigger("myFunction")
.timeBased()
.everyDays(3)
.create();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
n | Integer | Il numero di giorni tra le esecuzioni. |
Ritorni
ClockTriggerBuilder: lo strumento 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. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
everyMinutes(n)
Specifica di eseguire l'attivatore 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. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
everyWeeks(n)
Specifica di eseguire l'attivatore 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. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
inTimezone(timezone)
Specifica il fuso orario per le date/ore specificate quando viene eseguito l'attivatore. Per impostazione predefinita, il fuso orario è quello dello script.
L'elenco di stringhe di fuso orario valide corrisponde alle stringhe di fuso orario valide elencate da Joda.org. Una stringa del fuso orario non valida comporta un errore nello script.
// 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 relative all'ora dell'evento. |
Ritorni
ClockTriggerBuilder - Questo ClockTriggerBuilder, per il concatenamento.
nearMinute(minute)
Specifica il minuto di esecuzione del trigger (più o meno 15 minuti). Se nearMinute() non viene chiamato, viene utilizzato un valore 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 sparare. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
onMonthDay(day)
Specifica la data del mese in cui viene eseguito l'attivatore.
// Schedules for the first of every month
ScriptApp.newTrigger("myFunction")
.timeBased()
.onMonthDay(1)
.create();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
day | Integer | Il giorno del mese per cui deve essere pianificato l'attivatore. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.
onWeekDay(day)
Specifica il giorno della settimana in cui viene eseguito l'attivatore.
ScriptApp.newTrigger("myFunction")
.timeBased()
.onWeekDay(ScriptApp.WeekDay.FRIDAY)
.create();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
day | Weekday | Il giorno della settimana per l'attivazione. |
Ritorni
ClockTriggerBuilder: lo strumento per il concatenamento.