Class ClockTriggerBuilder

ClockTriggerBuilder

Un builder per i trigger di orologio.

Metodi

MetodoTipo restituitoBreve descrizione
after(durationMilliseconds)ClockTriggerBuilderSpecifica la durata minima (in millisecondi) dopo l'ora corrente di esecuzione del trigger.
at(date)ClockTriggerBuilderSpecifica quando viene eseguito il trigger.
atDate(year, month, day)ClockTriggerBuilderSpecifica che l'attivatore si attiva nella data specificata, per impostazione predefinita vicino a mezzanotte (+/- 15 minuti).
atHour(hour)ClockTriggerBuilderSpecifica l'ora in cui viene eseguito il trigger.
create()TriggerCrea il trigger.
everyDays(n)ClockTriggerBuilderSpecifica di eseguire il trigger ogni n giorni.
everyHours(n)ClockTriggerBuilderSpecifica di eseguire il trigger ogni n ore.
everyMinutes(n)ClockTriggerBuilderSpecifica di eseguire il trigger ogni n minuti.
everyWeeks(n)ClockTriggerBuilderSpecifica di eseguire il trigger ogni n settimane.
inTimezone(timezone)ClockTriggerBuilderSpecifica il fuso orario per le date e le ore specificate quando viene eseguito l'attivatore.
nearMinute(minute)ClockTriggerBuilderSpecifica il minuto in cui viene eseguito il trigger (più o meno 15 minuti).
onMonthDay(day)ClockTriggerBuilderSpecifica la data del mese in cui viene eseguito l'attivatore.
onWeekDay(day)ClockTriggerBuilderSpecifica 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

NomeTipoDescrizione
durationMillisecondsIntegerLa 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

NomeTipoDescrizione
dateDateUn 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

NomeTipoDescrizione
yearIntegerL'anno di calendario in cui pianificare il trigger.
monthIntegerIl mese di calendario per pianificare il trigger (deve essere un numero compreso tra 1 e 12, inclusi).
dayIntegerIl 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

NomeTipoDescrizione
hourIntegerL'ora in cui attivare.

Invio

ClockTriggerBuilder - Lo strumento di creazione, per il concatenamento.


create()

Crea il trigger.

Invio

Trigger: l'attivatore pianificato appena creato.


everyDays(n)

Specifica di eseguire il trigger ogni n giorni.

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

Parametri

NomeTipoDescrizione
nIntegerIl 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

NomeTipoDescrizione
nIntegerIl 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

NomeTipoDescrizione
nIntegerIl 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

NomeTipoDescrizione
nIntegerIl 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

NomeTipoDescrizione
timezoneStringIl 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

NomeTipoDescrizione
minuteIntegerIl 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

NomeTipoDescrizione
dayIntegerIl 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

NomeTipoDescrizione
dayWeekdayIl giorno della settimana all'attivazione.

Invio

ClockTriggerBuilder - Lo strumento di creazione, per il concatenamento.