Rappresenta una regola di ricorrenza per una serie di eventi.
Tieni presente che questa classe si comporta anche come l'elemento EventRecurrence
a cui appartiene,
consentendoti di concatenare la creazione di regole in questo modo:
recurrence.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
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
addDailyExclusion() | RecurrenceRule | Aggiunge una regola che esclude le occorrenze su base giornaliera. |
addDailyRule() | RecurrenceRule | Aggiunge una regola che determina la ripetizione giornaliera dell'evento. |
addDate(date) | EventRecurrence | Aggiunge una regola che fa sì che l'evento si ripeta in una data specifica. |
addDateExclusion(date) | EventRecurrence | Aggiunge una regola che esclude un'occorrenza per una data specifica. |
addMonthlyExclusion() | RecurrenceRule | Aggiunge una regola che esclude le occorrenze su base mensile. |
addMonthlyRule() | RecurrenceRule | Aggiunge una regola che determina la ripetizione mensile dell'evento. |
addWeeklyExclusion() | RecurrenceRule | Aggiunge una regola che esclude le occorrenze su base settimanale. |
addWeeklyRule() | RecurrenceRule | Aggiunge una regola che determina la ricorrenza dell'evento su base settimanale. |
addYearlyExclusion() | RecurrenceRule | Aggiunge una regola che esclude le occorrenze su base annuale. |
addYearlyRule() | RecurrenceRule | Aggiunge una regola che determina la ripetizione annuale dell'evento. |
interval(interval) | RecurrenceRule | Consente di configurare la regola in modo che venga applicata solo in questo intervallo dell'unità di tempo della regola. |
onlyInMonth(month) | RecurrenceRule | Configura la regola in modo che venga applicata solo a un mese specifico. |
onlyInMonths(months) | RecurrenceRule | Configura la regola in modo che venga applicata solo a mesi specifici. |
onlyOnMonthDay(day) | RecurrenceRule | Configura la regola in modo che venga applicata solo a un giorno specifico del mese. |
onlyOnMonthDays(days) | RecurrenceRule | Configura la regola in modo che venga applicata solo a giorni specifici del mese. |
onlyOnWeek(week) | RecurrenceRule | Configura la regola in modo che venga applicata solo a una determinata settimana dell'anno. |
onlyOnWeekday(day) | RecurrenceRule | Consente di configurare la regola in modo che venga applicata solo a un giorno della settimana specifico. |
onlyOnWeekdays(days) | RecurrenceRule | Configura la regola in modo che venga applicata solo a determinati giorni della settimana. |
onlyOnWeeks(weeks) | RecurrenceRule | Configura la regola in modo che venga applicata solo a settimane specifiche dell'anno. |
onlyOnYearDay(day) | RecurrenceRule | Configura la regola in modo che venga applicata solo a un giorno specifico dell'anno. |
onlyOnYearDays(days) | RecurrenceRule | Configura la regola in modo che venga applicata solo a determinati giorni dell'anno. |
setTimeZone(timeZone) | EventRecurrence | Imposta il fuso orario per questa ricorrenza. |
times(times) | RecurrenceRule | Configura la regola in modo che termini dopo un determinato numero di occorrenze. |
until(endDate) | RecurrenceRule | Configura la regola in modo che termini in una determinata data (inclusa). |
weekStartsOn(day) | RecurrenceRule | Consente di configurare il giorno in cui inizia la 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. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDailyRule()
Aggiunge una regola che determina la ripetizione giornaliera dell'evento.
// Creates a rule that recurs every day for ten days. var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDate(date)
Aggiunge una regola che fa sì che l'evento si ripeta in una data specifica.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date |
Ritorni
EventRecurrence
: questo EventRecurrence per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'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
Nome | Tipo | Descrizione |
---|---|---|
date | Date |
Ritorni
EventRecurrence
: questo EventRecurrence per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'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 lo stesso giorno del mese del primo evento della serie, ma è possibile modificarlo chiamando onlyOnMonthDay(day)
o onlyOnMonthDays(days)
.
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addMonthlyRule()
Aggiunge una regola che determina la ripetizione mensile dell'evento.
Per impostazione predefinita, l'evento si ripete lo stesso giorno del mese del primo evento della serie, ma è possibile modificarlo chiamando onlyOnMonthDay(day)
o onlyOnMonthDays(days)
.
// Creates a rule that recurs every month for three months. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'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 lo stesso giorno della settimana del primo evento della serie, ma questo può essere modificato chiamando onlyOnWeekday(day)
o onlyOnWeekdays(days)
.
// Creates a rule that recurs every day except the first four Wednesdays. var recurrence = CalendarApp.newRecurrence().addDailyRule() .addWeeklyExclusion().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY).times(4);
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addWeeklyRule()
Aggiunge una regola che determina la ricorrenza dell'evento su base settimanale.
Per impostazione predefinita, l'evento si ripete nello stesso giorno della settimana del primo evento della serie,
ma può essere modificato chiamando onlyOnWeekday(day)
o onlyOnWeekdays(days)
.
// Creates a rule that recurs every week for ten weeks. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'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 annuale.
Per impostazione predefinita, l'esclusione viene applicata lo stesso giorno dell'anno del primo evento della serie, ma è possibile modificarlo chiamando onlyOnYearDay(day)
o onlyOnYearDays(days)
.
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyRule()
Aggiunge una regola che determina la ripetizione annuale dell'evento.
Per impostazione predefinita, l'evento si ripete lo stesso giorno dell'anno del primo evento della serie, ma puoi modificare questo valore chiamando onlyOnYearDay(day)
o onlyOnYearDays(days)
.
Ritorni
RecurrenceRule
: la nuova regola di ricorrenza
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
interval(interval)
Consente di configurare 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. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
interval | Integer | l'intervallo nell'unità di tempo della regola |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
onlyInMonth(month)
Configura la regola in modo che venga applicata solo a un mese specifico.
// Creates a rule that recurs every week in February. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyInMonth(CalendarApp.Month.FEBRUARY);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
month | Month | il mese |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
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. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyInMonths([CalendarApp.Month.FEBRUARY, CalendarApp.Month.MARCH]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
months | Month[] | i mesi |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
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. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDay(5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
day | Integer | il giorno del mese |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
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. var recurrence = CalendarApp.newRecurrence().addMonthlyRule().onlyOnMonthDays([1, 15]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
days | Integer[] | i giorni del mese |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
onlyOnWeek(week)
Configura la regola in modo che venga applicata solo a una determinata settimana dell'anno.
// Creates a rule that recurs on the fifth week of every year. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
week | Integer | la settimana |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
onlyOnWeekday(day)
Consente di configurare la regola in modo che venga applicata solo a un giorno della settimana specifico.
// Creates a rule that recurs every week on Wednesdays. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
day | Weekday | il giorno della settimana |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
onlyOnWeekdays(days)
Configura la regola in modo che venga applicata solo a determinati giorni della settimana.
// Creates a rule that recurs every week on Tuesdays and Thursdays. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyOnWeekdays( [CalendarApp.Weekday.TUESDAY, CalendarApp.Weekday.THURSDAY]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
days | Weekday[] | i giorni della settimana |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
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. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeeks([5, 10]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
weeks | Integer[] | le settimane |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
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). var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay(46);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
day | Integer | il giorno dell'anno |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
onlyOnYearDays(days)
Configura la regola in modo che venga applicata solo a determinati giorni dell'anno.
// Creates a rule that recurs every year on January 20 and February 15. var recurrence = CalendarApp.newRecurrence().addYearlyRule().onlyOnYearDay([20, 46]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
days | Integer[] | i giorni dell'anno |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
setTimeZone(timeZone)
Imposta il fuso orario per questa ricorrenza. Questa impostazione influisce sulla data e sull'ora in cui gli eventi si ripetono e se l'evento cambia con l'ora legale. Il valore predefinito è il fuso orario del calendario.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
timeZone | String | il fuso orario, specificato nel formato "lungo" (ad es. 'America/New_York', come indicato da Joda.org) |
Ritorni
EventRecurrence
: questo EventRecurrence per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
times(times)
Configura la regola in modo che termini dopo un determinato numero di occorrenze.
// Creates a rule that recurs every day for ten days. var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
times | Integer | il numero di ripetizioni |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
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. var recurrence = CalendarApp.newRecurrence() .addDailyRule().until(new Date('December 31, 2013'));
Parametri
Nome | Tipo | Descrizione |
---|---|---|
endDate | Date |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti o ambiti appropriati dall'API REST correlata:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
weekStartsOn(day)
Consente di configurare il giorno in cui inizia la settimana ai fini dell'applicazione della regola.
// Creates a weekly rule where weeks start on Monday. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().weekStartsOn(CalendarApp.Weekday.MONDAY);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
day | Weekday | il giorno in cui inizia la settimana |
Ritorni
RecurrenceRule
: questa regola di ricorrenza per il concatenamento