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時區，以「long」格式指定 (例如「America/New_York」，如 Joda.org 所列)

回攻員

EventRecurrence - 用於串連的 EventRecurrence

授權

使用這個方法的指令碼需要透過下列一或多個範圍或相關 REST API 中的適當範圍授權：

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