Questa pagina è stata tradotta dall'API Cloud Translation.

Class ClockTriggerBuilder

Un generatore di trigger a tempo.

Metodi

Metodo	Tipo restituito	Breve descrizione
`after(durationMilliseconds)`	`ClockTriggerBuilder`	Specifica la durata minima (in millisecondi) dopo l'ora corrente in cui viene eseguito l'attivatore.
`at(date)`	`ClockTriggerBuilder`	Specifica quando viene eseguito l'attivatore.
`atDate(year, month, day)`	`ClockTriggerBuilder`	Specifica che l'attivatore viene attivato nella data specificata, per impostazione predefinita intorno a mezzanotte (+/- 15 minuti).
`atHour(hour)`	`ClockTriggerBuilder`	Specifica l'ora in cui viene eseguito l'attivatore.
`create()`	`Trigger`	Crea l'attivatore.
`everyDays(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore ogni `n` giorni.
`everyHours(n)`	`ClockTriggerBuilder`	Specifica di eseguire l'attivatore 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/l'ora specificate quando viene eseguito l'attivatore.
`nearMinute(minute)`	`ClockTriggerBuilder`	Specifica il minuto in cui viene eseguito l'attivatore (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 corrente in cui viene eseguito l'attivatore. La durata effettiva potrebbe 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 corrente in cui deve essere eseguito l'attivatore.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`at(date)`

Specifica quando viene eseguito l'attivatore.

// Creates a trigger for December 1, 2012
const triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	Un oggetto Date che rappresenta il momento in cui deve essere eseguito l'attivatore.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`atDate(year, month, day)`

Specifica che l'attivatore viene attivato nella data specificata, per impostazione predefinita intorno 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 pianificare l'attivatore.
`month`	`Integer`	Il mese di calendario per 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).

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`atHour(hour)`

Specifica l'ora in cui viene eseguito l'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 attivare l'azione.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`create()`

Crea l'attivatore.

Invio

Trigger: l'attivatore pianificato appena creato.

`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 un'esecuzione e l'altra.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`everyHours(n)`

Specifica di eseguire l'attivatore 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: il generatore, per l'accodamento.

`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 un'esecuzione e l'altra.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`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 un'esecuzione e l'altra.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`inTimezone(timezone)`

Specifica il fuso orario per le date/l'ora specificate quando viene eseguito l'attivatore. Per impostazione predefinita, il fusorario è quello dello script.

L'elenco delle stringhe dei fusi orari validi corrisponde a quelle elencate da Joda.org. Una stringa del fuso orario non valida provoca 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 sull'ora nell'evento.

Invio

ClockTriggerBuilder: questo ClockTriggerBuilder, per l'accodamento.

`nearMinute(minute)`

Specifica il minuto in cui viene eseguito l'attivatore (più o meno 15 minuti). Se nearMinute() non viene chiamato, viene utilizzato un valore casuale per i minuti.

// 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 l'azione.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`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.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.

`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 in cui attivare l'azione.

Invio

ClockTriggerBuilder: il generatore, per l'accodamento.