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.