Un builder per i trigger di orologio.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
after(durationMilliseconds) | ClockTriggerBuilder | Specifica la durata minima (in millisecondi) dopo l'ora corrente di esecuzione del trigger. |
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 in cui viene eseguito il trigger. |
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 e le ore specificate quando viene eseguito l'attivatore. |
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 l'attivatore. |
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 di esecuzione del 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 quando deve essere eseguito il trigger. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 Date che rappresenta quando deve essere eseguito il trigger. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 in cui pianificare il trigger. |
month | Integer | Il mese di calendario per pianificare il trigger (deve essere un numero compreso tra 1 e 12, inclusi). |
day | Integer | Il giorno di calendario per pianificare il trigger (deve essere un numero compreso tra 1 e 31, inclusi). |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, per il concatenamento.
atHour(hour)
Specifica l'ora in cui viene eseguito il trigger.
// 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. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, per il concatenamento.
create()
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. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 un'esecuzione e l'altra. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 un'esecuzione e l'altra. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 un'esecuzione e l'altra. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, per il concatenamento.
inTimezone(timezone)
Specifica il fuso orario per le date e le ore specificate quando viene eseguito l'attivatore. Per impostazione predefinita, il fuso orario è quello dello script.
L'elenco di stringhe di fusi orari valide corrisponde alle stringhe di fusi orari valide elencate da Joda.org. Una stringa del fuso orario non valida fa sì che lo script restituisca 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. |
Invio
ClockTriggerBuilder
: 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. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 in cui deve essere pianificato il trigger. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, 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 all'attivazione. |
Invio
ClockTriggerBuilder
- Lo strumento di creazione, per il concatenamento.