Esta página foi traduzida pela API Cloud Translation.

Class RecurrenceRule

Representa uma regra de recorrência para uma série de eventos.

Essa classe também se comporta como a EventRecurrence a que ela pertence. o que permite encadear a criação de regras da seguinte forma:

recurrence.addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);

Modificadores como times(times) e interval(interval) são aplicados à regra adicionada mais recentemente.

Métodos

Método	Tipo de retorno	Breve descrição
`addDailyExclusion()`	`RecurrenceRule`	Adiciona uma regra que exclui ocorrências diárias.
`addDailyRule()`	`RecurrenceRule`	Adiciona uma regra que faz com que o evento se repita diariamente.
`addDate(date)`	`EventRecurrence`	Adiciona uma regra que faz com que o evento se repita em uma data específica.
`addDateExclusion(date)`	`EventRecurrence`	Adiciona uma regra que exclui uma ocorrência em uma data específica.
`addMonthlyExclusion()`	`RecurrenceRule`	Adiciona uma regra que exclui ocorrências mensalmente.
`addMonthlyRule()`	`RecurrenceRule`	Adiciona uma regra que faz com que o evento se repita mensalmente.
`addWeeklyExclusion()`	`RecurrenceRule`	Adiciona uma regra que exclui ocorrências semanalmente.
`addWeeklyRule()`	`RecurrenceRule`	Adiciona uma regra que faz com que o evento se repita semanalmente.
`addYearlyExclusion()`	`RecurrenceRule`	Adiciona uma regra que exclui ocorrências anualmente.
`addYearlyRule()`	`RecurrenceRule`	Adiciona uma regra que faz com que o evento se repita anualmente.
`interval(interval)`	`RecurrenceRule`	Configura a regra para ser aplicada somente nesse intervalo da unidade de tempo da regra.
`onlyInMonth(month)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a um mês específico.
`onlyInMonths(months)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a meses específicos.
`onlyOnMonthDay(day)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a um dia específico do mês.
`onlyOnMonthDays(days)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a dias específicos do mês.
`onlyOnWeek(week)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a uma semana específica do ano.
`onlyOnWeekday(day)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a um dia específico da semana.
`onlyOnWeekdays(days)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a dias específicos da semana.
`onlyOnWeeks(weeks)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a semanas específicas do ano.
`onlyOnYearDay(day)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a um dia específico do ano.
`onlyOnYearDays(days)`	`RecurrenceRule`	Configura a regra para ser aplicada apenas a dias específicos do ano.
`setTimeZone(timeZone)`	`EventRecurrence`	Define o fuso horário para essa recorrência.
`times(times)`	`RecurrenceRule`	Configura a regra para terminar após um determinado número de ocorrências.
`until(endDate)`	`RecurrenceRule`	Configura a regra para terminar em uma determinada data (inclusive).
`weekStartsOn(day)`	`RecurrenceRule`	Configura o dia em que a semana começa para fins de aplicação da regra.

Documentação detalhada

`addDailyExclusion()`

Adiciona uma regra que exclui ocorrências diárias.

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

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addDailyRule()`

Adiciona uma regra que faz com que o evento se repita diariamente.

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

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addDate(date)`

Adiciona uma regra que faz com que o evento se repita em uma data específica.

Parâmetros

Nome	Tipo	Descrição
`date`	`Date`

Retornar

EventRecurrence: este EventRecurrence para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addDateExclusion(date)`

Adiciona uma regra que exclui uma ocorrência em uma data específica.

Parâmetros

Nome	Tipo	Descrição
`date`	`Date`

Retornar

EventRecurrence: este EventRecurrence para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addMonthlyExclusion()`

Adiciona uma regra que exclui ocorrências mensalmente.

Por padrão, a exclusão é aplicada no mesmo dia do mês que o primeiro evento no série, mas isso pode ser alterado chamando onlyOnMonthDay(day) ou onlyOnMonthDays(days).

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addMonthlyRule()`

Adiciona uma regra que faz com que o evento se repita mensalmente.

Por padrão, o evento se repete no mesmo dia do mês que o primeiro evento da série, mas isso pode ser alterado chamando onlyOnMonthDay(day) ou onlyOnMonthDays(days).

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

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addWeeklyExclusion()`

Adiciona uma regra que exclui ocorrências semanalmente.

Por padrão, a exclusão é aplicada no mesmo dia da semana que o primeiro evento na série, mas isso pode ser alterado chamando onlyOnWeekday(day) ou 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);

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addWeeklyRule()`

Adiciona uma regra que faz com que o evento se repita semanalmente.

Por padrão, o evento se repete no mesmo dia da semana que o primeiro evento da série, mas isso pode ser alterado chamando onlyOnWeekday(day) ou onlyOnWeekdays(days).

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

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addYearlyExclusion()`

Adiciona uma regra que exclui ocorrências anualmente.

Por padrão, a exclusão é aplicada no mesmo dia do ano que o primeiro evento da série, mas isso pode ser alterado chamando onlyOnYearDay(day) ou onlyOnYearDays(days).

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`addYearlyRule()`

Adiciona uma regra que faz com que o evento se repita anualmente.

Por padrão, o evento se repete no mesmo dia do ano que o primeiro evento da série, mas isso pode ser alterado chamando onlyOnYearDay(day) ou onlyOnYearDays(days).

Retornar

RecurrenceRule: a nova RecurrenceRule

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`interval(interval)`

Configura a regra para ser aplicada somente nesse intervalo da unidade de tempo da regra.

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

Parâmetros

Nome	Tipo	Descrição
`interval`	`Integer`	o intervalo na unidade de tempo da regra

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyInMonth(month)`

Configura a regra para ser aplicada apenas a um mês específico.

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

Parâmetros

Nome	Tipo	Descrição
`month`	`Month`	o mês

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyInMonths(months)`

Configura a regra para ser aplicada apenas a meses específicos.

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

Parâmetros

Nome	Tipo	Descrição
`months`	`Month[]`	os meses

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnMonthDay(day)`

Configura a regra para ser aplicada apenas a um dia específico do mês.

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

Parâmetros

Nome	Tipo	Descrição
`day`	`Integer`	o dia do mês

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnMonthDays(days)`

Configura a regra para ser aplicada apenas a dias específicos do mês.

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

Parâmetros

Nome	Tipo	Descrição
`days`	`Integer[]`	os dias do mês

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnWeek(week)`

Configura a regra para ser aplicada apenas a uma semana específica do ano.

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

Parâmetros

Nome	Tipo	Descrição
`week`	`Integer`	a semana

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnWeekday(day)`

Configura a regra para ser aplicada apenas a um dia específico da semana.

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

Parâmetros

Nome	Tipo	Descrição
`day`	`Weekday`	o dia da semana

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnWeekdays(days)`

Configura a regra para ser aplicada apenas a dias específicos da semana.

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

Parâmetros

Nome	Tipo	Descrição
`days`	`Weekday[]`	os dias da semana

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnWeeks(weeks)`

Configura a regra para ser aplicada apenas a semanas específicas do ano.

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

Parâmetros

Nome	Tipo	Descrição
`weeks`	`Integer[]`	as semanas

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnYearDay(day)`

Configura a regra para ser aplicada apenas a um dia específico do ano.

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

Parâmetros

Nome	Tipo	Descrição
`day`	`Integer`	o dia do ano

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`onlyOnYearDays(days)`

Configura a regra para ser aplicada apenas a dias específicos do ano.

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

Parâmetros

Nome	Tipo	Descrição
`days`	`Integer[]`	os dias do ano

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`setTimeZone(timeZone)`

Define o fuso horário para essa recorrência. Isso afeta a data e a hora em que os eventos se repetem e se o evento muda de acordo com o horário de verão. O padrão é o fuso horário da agenda.

Parâmetros

Nome	Tipo	Descrição
`timeZone`	`String`	o fuso horário, especificado em "longo", formato (por exemplo, "América/Nova_York", conforme listado por Joda.org)

Retornar

EventRecurrence: este EventRecurrence para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`times(times)`

Configura a regra para terminar após um determinado número de ocorrências.

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

Parâmetros

Nome	Tipo	Descrição
`times`	`Integer`	o número de vezes

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

`until(endDate)`

Configura a regra para terminar em uma determinada data (inclusive).

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

Parâmetros

Nome	Tipo	Descrição
`endDate`	`Date`

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos escopos a seguir ou escopos apropriados da API REST relacionada:

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

`weekStartsOn(day)`

Configura o dia em que a semana começa para fins de aplicação da regra.

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

Parâmetros

Nome	Tipo	Descrição
`day`	`Weekday`	o dia em que a semana começa

Retornar

RecurrenceRule: essa RecurrenceRule para encadeamento