Class 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.
const 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.
const 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.
const 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.
const 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.
const 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”格式指定（例如Joda.org 中列出的“America/New_York”）

返回

EventRecurrence - 用于链式调用的 EventRecurrence

授权

使用此方法的脚本需要具有以下一个或多个作用域或相关 REST API 中的适当作用域的授权：

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