Class EventRecurrence

EventRecurrence

表示活动系列的重复规则设置。

方法

方法返回类型简介
addDailyExclusion()RecurrenceRule添加每天排除出现的规则。
addDailyRule()RecurrenceRule添加规则，使活动每天重复。
addDate(date)EventRecurrence添加规则，使活动在特定日期重复。
addDateExclusion(date)EventRecurrence添加规则，将特定日期的例外情况排除在外。
addMonthlyExclusion()RecurrenceRule添加每月排除一次出现的规则。
addMonthlyRule()RecurrenceRule添加规则，使活动每月重复一次。
addWeeklyExclusion()RecurrenceRule添加每周排除一次出现的规则。
addWeeklyRule()RecurrenceRule添加规则，使活动每周重复。
addYearlyExclusion()RecurrenceRule添加每年排除一次实例的规则。
addYearlyRule()RecurrenceRule添加规则，使活动每年重复一次。
setTimeZone(timeZone)EventRecurrence设置重复周期的时区。

详细文档

addDailyExclusion()

添加每天排除出现的规则。 

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

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addDailyRule()

添加规则，使活动每天重复。 

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

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addDate(date)

添加规则，使活动在特定日期重复。

参数

名称类型说明
dateDate

返回

EventRecurrence - 此 EventRecurrence，用于链

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addDateExclusion(date)

添加规则，将特定日期的例外情况排除在外。

参数

名称类型说明
dateDate

返回

EventRecurrence - 此 EventRecurrence，用于链

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addMonthlyExclusion()

添加每月排除一次出现的规则。

默认情况下，此排除对象会在当月内第一个事件的同一天应用 但可通过调用 RecurrenceRule.onlyOnMonthDay(day) 或 RecurrenceRule.onlyOnMonthDays(days) 进行更改。

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addMonthlyRule()

添加规则，使活动每月重复一次。

默认情况下，活动在当月的同一天重复，作为系列中的第一个活动。 但可通过调用 RecurrenceRule.onlyOnMonthDay(day) 或 RecurrenceRule.onlyOnMonthDays(days) 进行更改。 

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

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addWeeklyExclusion()

添加每周排除一次出现的规则。

默认情况下，排除设置会在一周中的同一天应用 但可通过调用 RecurrenceRule.onlyOnWeekday(day) 或 RecurrenceRule.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);

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addWeeklyRule()

添加规则，使活动每周重复。

默认情况下，活动在每周的同一天重复，与系列中的第一个活动相同。 但可通过调用 RecurrenceRule.onlyOnWeekday(day) 或 RecurrenceRule.onlyOnWeekdays(days) 进行更改。 

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

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addYearlyExclusion()

添加每年排除一次实例的规则。

默认情况下，此排除对象会在当年中第一个事件的同一天应用 但可通过调用 RecurrenceRule.onlyOnYearDay(day) 或 RecurrenceRule.onlyOnYearDays(days) 进行更改。

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

addYearlyRule()

添加规则，使活动每年重复一次。

默认情况下，活动在每年的同一天重复，这与系列中的第一个活动相同。 但可通过调用 RecurrenceRule.onlyOnYearDay(day) 或 RecurrenceRule.onlyOnYearDays(days) 进行更改。

返回

RecurrenceRule - 新的 RecurrenceRule

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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

setTimeZone(timeZone)

设置重复周期的时区。这会影响活动重复发生的日期和时间， 以及活动时间是否会根据夏令时进行相应调整。默认为日历的时区。

参数

名称类型说明
timeZoneString时区，以“long”指定格式（例如，“America/New_York”，如下所列 Joda.org 提供）

返回

EventRecurrence - 此 EventRecurrence，用于链

授权

使用此方法的脚本需要以下一个或多个范围或相关 REST API 的适当范围的授权：

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