Class RecurrenceRule

Regoladiripetizione

Rappresenta una regola di ricorrenza per una serie di eventi.

Tieni presente che questo tipo di regola si comporta anche come il tipo EventRecurrence a cui appartiene, consentendoti di collegare la creazione di regole come segue:

const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
I modificatori come times(times) e interval(interval) vengono applicati alla regola aggiunta più di recente.

Metodi

MetodoTipo restituitoBreve descrizione
addDailyExclusion()RecurrenceRuleAggiunge una regola che esclude le occorrenze su base giornaliera.
addDailyRule()RecurrenceRuleAggiunge una regola che fa sì che l'evento si ripeta su base giornaliera.
addDate(date)EventRecurrenceAggiunge una regola che determina la ripetizione dell'evento in una data specifica.
addDateExclusion(date)EventRecurrenceAggiunge una regola che esclude un'occorrenza per una data specifica.
addMonthlyExclusion()RecurrenceRuleAggiunge una regola che esclude le occorrenze su base mensile.
addMonthlyRule()RecurrenceRuleAggiunge una regola che fa sì che l'evento si ripeta su base mensile.
addWeeklyExclusion()RecurrenceRuleAggiunge una regola che esclude le occorrenze su base settimanale.
addWeeklyRule()RecurrenceRuleAggiunge una regola che fa sì che l'evento si ripeta su base settimanale.
addYearlyExclusion()RecurrenceRuleAggiunge una regola che esclude le occorrenze su base annua.
addYearlyRule()RecurrenceRuleAggiunge una regola che fa sì che l'evento si ripeta ogni anno.
interval(interval)RecurrenceRuleConfigura la regola in modo che venga applicata solo in questo intervallo dell'unità di tempo della regola.
onlyInMonth(month)RecurrenceRuleConfigura la regola in modo che venga applicata solo a un mese specifico.
onlyInMonths(months)RecurrenceRuleConfigura la regola in modo che venga applicata solo a mesi specifici.
onlyOnMonthDay(day)RecurrenceRuleConfigura la regola in modo che venga applicata solo a un giorno specifico del mese.
onlyOnMonthDays(days)RecurrenceRuleConfigura la regola in modo che venga applicata solo a giorni specifici del mese.
onlyOnWeek(week)RecurrenceRuleConfigura la regola in modo che venga applicata solo a una settimana specifica dell'anno.
onlyOnWeekday(day)RecurrenceRuleConfigura la regola in modo che venga applicata solo a un giorno specifico della settimana.
onlyOnWeekdays(days)RecurrenceRuleConfigura la regola in modo che venga applicata solo a giorni specifici della settimana.
onlyOnWeeks(weeks)RecurrenceRuleConfigura la regola in modo che venga applicata solo a settimane specifiche dell'anno.
onlyOnYearDay(day)RecurrenceRuleConfigura la regola in modo che venga applicata solo a un giorno specifico dell'anno.
onlyOnYearDays(days)RecurrenceRuleConfigura la regola in modo che venga applicata solo a giorni specifici dell'anno.
setTimeZone(timeZone)EventRecurrenceImposta il fuso orario per questa ricorrenza.
times(times)RecurrenceRuleConsente di configurare la regola in modo che termini dopo un determinato numero di occorrenze.
until(endDate)RecurrenceRuleConfigura la regola in modo che termini in una determinata data (inclusa).
weekStartsOn(day)RecurrenceRuleConfigura il giorno di inizio della settimana ai fini dell'applicazione della regola.

Documentazione dettagliata

addDailyExclusion()

Aggiunge una regola che esclude le occorrenze su base giornaliera.

// Creates a rule that recurs every week after the first 30 days.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDailyRule()

Aggiunge una regola che fa sì che l'evento si ripeta su base giornaliera.

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDate(date)

Aggiunge una regola che determina la ripetizione dell'evento in una data specifica.

Parametri

NomeTipoDescrizione
dateDate

Invio

EventRecurrence - questa EventRecurrence per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addDateExclusion(date)

Aggiunge una regola che esclude un'occorrenza per una data specifica.

Parametri

NomeTipoDescrizione
dateDate

Invio

EventRecurrence - questa EventRecurrence per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addMonthlyExclusion()

Aggiunge una regola che esclude le occorrenze su base mensile.

Per impostazione predefinita, l'esclusione viene applicata nello stesso giorno del mese del primo evento della serie, ma questo valore può essere modificato chiamando onlyOnMonthDay(day) o onlyOnMonthDays(days).

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addMonthlyRule()

Aggiunge una regola che fa sì che l'evento si ripeta su base mensile.

Per impostazione predefinita, l'evento si ripete nello stesso giorno del mese del primo evento della serie, ma questo valore può essere modificato chiamando onlyOnMonthDay(day) o onlyOnMonthDays(days).

// Creates a rule that recurs every month for three months.
const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addWeeklyExclusion()

Aggiunge una regola che esclude le occorrenze su base settimanale.

Per impostazione predefinita, l'esclusione viene applicata nello stesso giorno della settimana del primo evento della serie, ma questo valore può essere modificato chiamando onlyOnWeekday(day) o onlyOnWeekdays(days).

// Creates a rule that recurs every day except the first four Wednesdays.
const recurrence = CalendarApp.newRecurrence()
                       .addDailyRule()
                       .addWeeklyExclusion()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .times(4);

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addWeeklyRule()

Aggiunge una regola che fa sì che l'evento si ripeta su base settimanale.

Per impostazione predefinita, l'evento si ripete nello stesso giorno della settimana del primo evento della serie, ma questo valore può essere modificato chiamando onlyOnWeekday(day) o onlyOnWeekdays(days).

// Creates a rule that recurs every week for ten weeks.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addYearlyExclusion()

Aggiunge una regola che esclude le occorrenze su base annua.

Per impostazione predefinita, l'esclusione viene applicata nello stesso giorno dell'anno del primo evento della serie, ma questo valore può essere modificato chiamando onlyOnYearDay(day) o onlyOnYearDays(days).

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

addYearlyRule()

Aggiunge una regola che fa sì che l'evento si ripeta ogni anno.

Per impostazione predefinita, l'evento si ripete nello stesso giorno dell'anno del primo evento della serie, ma questo valore può essere modificato chiamando onlyOnYearDay(day) o onlyOnYearDays(days).

Invio

RecurrenceRule: la nuova regola RecurrenceRule

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

interval(interval)

Configura la regola in modo che venga applicata solo in questo intervallo dell'unità di tempo della regola.

// Creates a rule that recurs every fourth week.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

Parametri

NomeTipoDescrizione
intervalIntegerl'intervallo nell'unità di tempo della regola

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyInMonth(month)

Configura la regola in modo che venga applicata solo a un mese specifico.

// Creates a rule that recurs every week in February.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonth(
    CalendarApp.Month.FEBRUARY);

Parametri

NomeTipoDescrizione
monthMonthil mese

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyInMonths(months)

Configura la regola in modo che venga applicata solo a mesi specifici.

// Creates a rule that recurs every week in February and March.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyInMonths(
    [CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);

Parametri

NomeTipoDescrizione
monthsMonth[]i mesi

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnMonthDay(day)

Configura la regola in modo che venga applicata solo a un giorno specifico del mese.

// Creates a rule that recurs every month on the fifth day of the month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);

Parametri

NomeTipoDescrizione
dayIntegeril giorno del mese

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnMonthDays(days)

Configura la regola in modo che venga applicata solo a giorni specifici del mese.

// Creates a rule that recurs every month on the first and fifteenth day of the
// month.
const recurrence =
    CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);

Parametri

NomeTipoDescrizione
daysInteger[]i giorni del mese

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnWeek(week)

Configura la regola in modo che venga applicata solo a una settimana specifica dell'anno.

// Creates a rule that recurs on the fifth week of every year.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);

Parametri

NomeTipoDescrizione
weekIntegerla settimana

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnWeekday(day)

Configura la regola in modo che venga applicata solo a un giorno specifico della settimana.

// Creates a rule that recurs every week on Wednesdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekday(
    CalendarApp.Weekday.WEDNESDAY);

Parametri

NomeTipoDescrizione
dayWeekdayil giorno della settimana

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnWeekdays(days)

Configura la regola in modo che venga applicata solo a giorni specifici della settimana.

// Creates a rule that recurs every week on Tuesdays and Thursdays.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeekdays(
    [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]);

Parametri

NomeTipoDescrizione
daysWeekday[]i giorni della settimana

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnWeeks(weeks)

Configura la regola in modo che venga applicata solo a settimane specifiche dell'anno.

// Creates a rule that recurs on the fifth and tenth weeks of every year.
const recurrence =
    CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);

Parametri

NomeTipoDescrizione
weeksInteger[]le settimane

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnYearDay(day)

Configura la regola in modo che venga applicata solo a un giorno specifico dell'anno.

// Creates a rule that recurs every year on February 15 (the 46th day).
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);

Parametri

NomeTipoDescrizione
dayIntegeril giorno dell'anno

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


onlyOnYearDays(days)

Configura la regola in modo che venga applicata solo a giorni specifici dell'anno.

// Creates a rule that recurs every year on January 20 and February 15.
const recurrence =
    CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);

Parametri

NomeTipoDescrizione
daysInteger[]i giorni dell'anno

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


setTimeZone(timeZone)

Imposta il fuso orario per questa ricorrenza. Questo influisce sulla data e sull'ora di ripetizione degli eventi e su come l'evento cambia con l'ora legale. Il valore predefinito è il fuso orario del calendario.

Parametri

NomeTipoDescrizione
timeZoneStringil fuso orario, specificato in formato "long" (ad es. 'America/New_York', come indicato da Joda.org)

Invio

EventRecurrence - questa EventRecurrence per l'accodamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

times(times)

Consente di configurare la regola in modo che termini dopo un determinato numero di occorrenze.

// Creates a rule that recurs every day for ten days.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

Parametri

NomeTipoDescrizione
timesIntegeril numero di volte da ripetere

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento


until(endDate)

Configura la regola in modo che termini in una determinata data (inclusa).

// Creates a rule that recurs every day through the end of 2013.
const recurrence = CalendarApp.newRecurrence().addDailyRule().until(
    new Date('December 31, 2013'));

Parametri

NomeTipoDescrizione
endDateDate

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o con gli ambiti appropriati dell'API REST correlata:

  • https://www.googleapis.com/auth/calendar
  • https://www.google.com/calendar/feeds

weekStartsOn(day)

Configura il giorno di inizio della settimana ai fini dell'applicazione della regola.

// Creates a weekly rule where weeks start on Monday.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

Parametri

NomeTipoDescrizione
dayWeekdayil giorno in cui inizia la settimana

Invio

RecurrenceRule: questa regola di ripetizione per l'accoppiamento