Questa pagina è stata tradotta dall'API Cloud Translation.

Class ClockTriggerBuilder

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()`

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

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.