Rappresenta una regola di ricorrenza per una serie di eventi.
Tieni presente che questo tipo di regola si comporta anche come il tipo Event
a cui appartiene,
consentendoti di collegare la creazione di regole come segue:
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);
times(times)
e interval(interval)
vengono applicati alla regola aggiunta più di recente.Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
add | Recurrence | Aggiunge una regola che esclude le occorrenze su base giornaliera. |
add | Recurrence | Aggiunge una regola che fa sì che l'evento si ripeta su base giornaliera. |
add | Event | Aggiunge una regola che determina la ripetizione dell'evento in una data specifica. |
add | Event | Aggiunge una regola che esclude un'occorrenza per una data specifica. |
add | Recurrence | Aggiunge una regola che esclude le occorrenze su base mensile. |
add | Recurrence | Aggiunge una regola che fa sì che l'evento si ripeta su base mensile. |
add | Recurrence | Aggiunge una regola che esclude le occorrenze su base settimanale. |
add | Recurrence | Aggiunge una regola che fa sì che l'evento si ripeta su base settimanale. |
add | Recurrence | Aggiunge una regola che esclude le occorrenze su base annua. |
add | Recurrence | Aggiunge una regola che fa sì che l'evento si ripeta ogni anno. |
interval(interval) | Recurrence | Configura la regola in modo che venga applicata solo in questo intervallo dell'unità di tempo della regola. |
only | Recurrence | Configura la regola in modo che venga applicata solo a un mese specifico. |
only | Recurrence | Configura la regola in modo che venga applicata solo a mesi specifici. |
only | Recurrence | Configura la regola in modo che venga applicata solo a un giorno specifico del mese. |
only | Recurrence | Configura la regola in modo che venga applicata solo a giorni specifici del mese. |
only | Recurrence | Configura la regola in modo che venga applicata solo a una settimana specifica dell'anno. |
only | Recurrence | Configura la regola in modo che venga applicata solo a un giorno specifico della settimana. |
only | Recurrence | Configura la regola in modo che venga applicata solo a giorni specifici della settimana. |
only | Recurrence | Configura la regola in modo che venga applicata solo a settimane specifiche dell'anno. |
only | Recurrence | Configura la regola in modo che venga applicata solo a un giorno specifico dell'anno. |
only | Recurrence | Configura la regola in modo che venga applicata solo a giorni specifici dell'anno. |
set | Event | Imposta il fuso orario per questa ricorrenza. |
times(times) | Recurrence | Consente di configurare la regola in modo che termini dopo un determinato numero di occorrenze. |
until(endDate) | Recurrence | Configura la regola in modo che termini in una determinata data (inclusa). |
week | Recurrence | Configura il giorno di inizio della settimana ai fini dell'applicazione della regola. |
Documentazione dettagliata
add Daily Exclusion()
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
Recurrence
: 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
add Daily Rule()
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
Recurrence
: 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
add Date(date)
Aggiunge una regola che determina la ripetizione dell'evento in una data specifica.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date |
Invio
Event
- 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
add Date Exclusion(date)
Aggiunge una regola che esclude un'occorrenza per una data specifica.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date |
Invio
Event
- 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
add Monthly Exclusion()
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 only
o only
.
Invio
Recurrence
: 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
add Monthly Rule()
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 only
o only
.
// Creates a rule that recurs every month for three months. const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);
Invio
Recurrence
: 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
add Weekly Exclusion()
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 only
o only
.
// 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
Recurrence
: 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
add Weekly Rule()
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 only
o only
.
// Creates a rule that recurs every week for ten weeks. const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);
Invio
Recurrence
: 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
add Yearly Exclusion()
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 only
o only
.
Invio
Recurrence
: 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
add Yearly Rule()
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 only
o only
.
Invio
Recurrence
: 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
Nome | Tipo | Descrizione |
---|---|---|
interval | Integer | l'intervallo nell'unità di tempo della regola |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only In Month(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
Nome | Tipo | Descrizione |
---|---|---|
month | Month | il mese |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only In Months(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
Nome | Tipo | Descrizione |
---|---|---|
months | Month[] | i mesi |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Month Day(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
Nome | Tipo | Descrizione |
---|---|---|
day | Integer | il giorno del mese |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Month Days(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
Nome | Tipo | Descrizione |
---|---|---|
days | Integer[] | i giorni del mese |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Week(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
Nome | Tipo | Descrizione |
---|---|---|
week | Integer | la settimana |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Weekday(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
Nome | Tipo | Descrizione |
---|---|---|
day | Weekday | il giorno della settimana |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Weekdays(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
Nome | Tipo | Descrizione |
---|---|---|
days | Weekday[] | i giorni della settimana |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Weeks(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
Nome | Tipo | Descrizione |
---|---|---|
weeks | Integer[] | le settimane |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Year Day(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
Nome | Tipo | Descrizione |
---|---|---|
day | Integer | il giorno dell'anno |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
only On Year Days(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
Nome | Tipo | Descrizione |
---|---|---|
days | Integer[] | i giorni dell'anno |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento
set Time Zone(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
Nome | Tipo | Descrizione |
---|---|---|
time | String | il fuso orario, specificato in formato "long" (ad es. 'America/New_York', come indicato da Joda.org) |
Invio
Event
- 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
Nome | Tipo | Descrizione |
---|---|---|
times | Integer | il numero di volte da ripetere |
Invio
Recurrence
: 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
Nome | Tipo | Descrizione |
---|---|---|
end | Date |
Invio
Recurrence
: 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
week Starts On(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
Nome | Tipo | Descrizione |
---|---|---|
day | Weekday | il giorno in cui inizia la settimana |
Invio
Recurrence
: questa regola di ripetizione per l'accoppiamento