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.
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时区，以“长”格式指定（例如， Joda.org 列出的“America/New_York”）

返回

EventRecurrence - 用于链式调用的此 EventRecurrence

授权

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

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