דף זה תורגם על ידי Cloud Translation API.

Class RecurrenceRule

מייצג כלל של חזרה על אירועים בסדרה.

שימו לב שהכיתה הזו מתנהגת גם כמו ה-EventRecurrence שהיא שייכת אליו, ומאפשרת לכם לשרשר יצירת כללים יחד כך:

const recurrence = CalendarApp.newRecurrence().addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);

משתני אופן פעולה כמו times(times) ו-interval(interval) חלים על הכלל שנוסף לאחרונה.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`addDailyExclusion()`	`RecurrenceRule`	הוספת כלל שמחריג אירועים שמתרחשים על בסיס יומי.
`addDailyRule()`	`RecurrenceRule`	הוספת כלל שגורם לאירוע לחזור על עצמו מדי יום.
`addDate(date)`	`EventRecurrence`	הוספת כלל שגורם לאירוע לחזור בתאריך ספציפי.
`addDateExclusion(date)`	`EventRecurrence`	הוספת כלל להחרגת אירוע בתאריך ספציפי.
`addMonthlyExclusion()`	`RecurrenceRule`	הוספת כלל להחרגת אירועים על בסיס חודשי.
`addMonthlyRule()`	`RecurrenceRule`	הוספת כלל שגורם לאירוע לחזור על עצמו על בסיס חודשי.
`addWeeklyExclusion()`	`RecurrenceRule`	הוספת כלל שמחריג אירועים שקרו על בסיס שבועי.
`addWeeklyRule()`	`RecurrenceRule`	הוספת כלל שגורם לאירוע לחזור על עצמו על בסיס שבועי.
`addYearlyExclusion()`	`RecurrenceRule`	הוספת כלל להחרגת אירועים שנערכים על בסיס שנתי.
`addYearlyRule()`	`RecurrenceRule`	הוספת כלל שגורם לאירוע לחזור על עצמו מדי שנה.
`interval(interval)`	`RecurrenceRule`	ההגדרה קובעת שהכלל יחול רק במרווח הזמן הזה ביחידה הזמן של הכלל.
`onlyInMonth(month)`	`RecurrenceRule`	הגדרת הכלל כך שיחול רק על חודש ספציפי.
`onlyInMonths(months)`	`RecurrenceRule`	הגדרת הכלל כך שיחול רק על חודשים ספציפיים.
`onlyOnMonthDay(day)`	`RecurrenceRule`	הגדרת הכלל כך שיחול רק על יום ספציפי בחודש.
`onlyOnMonthDays(days)`	`RecurrenceRule`	הגדרת הכלל כך שיחול רק על ימים ספציפיים בחודש.
`onlyOnWeek(week)`	`RecurrenceRule`	מגדירים את הכלל כך שיחול רק על שבוע ספציפי בשנה.
`onlyOnWeekday(day)`	`RecurrenceRule`	מגדירים את הכלל כך שיחול רק על יום ספציפי בשבוע.
`onlyOnWeekdays(days)`	`RecurrenceRule`	מגדירים את הכלל כך שיחול רק על ימים ספציפיים בשבוע.
`onlyOnWeeks(weeks)`	`RecurrenceRule`	מגדירים את הכלל כך שיחול רק על שבועות ספציפיים בשנה.
`onlyOnYearDay(day)`	`RecurrenceRule`	מגדירים את הכלל כך שיחול רק על יום ספציפי בשנה.
`onlyOnYearDays(days)`	`RecurrenceRule`	מגדירים את הכלל כך שיחול רק על ימים ספציפיים בשנה.
`setTimeZone(timeZone)`	`EventRecurrence`	הגדרת אזור הזמן של החזרה.
`times(times)`	`RecurrenceRule`	הגדרת הכלל כך שיסתיים אחרי מספר נתון של אירועים.
`until(endDate)`	`RecurrenceRule`	הגדרת הכלל כך שיסתיים בתאריך נתון (כולל).
`weekStartsOn(day)`	`RecurrenceRule`	הגדרת היום שבו השבוע מתחיל, לצורך החלת הכלל.

מסמכים מפורטים

`addDailyExclusion()`

הוספת כלל שמחריג אירועים שמתרחשים על בסיס יומי.

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

חזרה

RecurrenceRule – ה-RecurrenceRule החדש

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מההיקפי הגישה הבאים, או עם היקפי גישה מתאימים מה-API ל-REST הקשור:

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 החדש

אישור

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

`addDate(date)`

הוספת כלל שגורם לאירוע לחזור בתאריך ספציפי.

פרמטרים

שם	סוג	תיאור
`date`	`Date`

חזרה

EventRecurrence – האירוע הזה של EventRecurrence לשרשור

אישור

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

`addDateExclusion(date)`

הוספת כלל להחרגת אירוע בתאריך ספציפי.

פרמטרים

שם	סוג	תיאור
`date`	`Date`

חזרה

EventRecurrence – האירוע הזה של EventRecurrence לשרשור

אישור

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

`addMonthlyExclusion()`

הוספת כלל להחרגת אירועים על בסיס חודשי.

כברירת מחדל, ההחרגה חלה באותו יום בחודש שבו מתקיים האירוע הראשון בסדרה, אבל אפשר לשנות זאת באמצעות קריאה לפונקציה onlyOnMonthDay(day) או onlyOnMonthDays(days).

חזרה

RecurrenceRule – ה-RecurrenceRule החדש

אישור

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

`addMonthlyRule()`

הוספת כלל שגורם לאירוע לחזור על עצמו על בסיס חודשי.

כברירת מחדל, האירוע חוזר על עצמו באותו יום בחודש שבו חל האירוע הראשון בסדרה, אבל אפשר לשנות את זה באמצעות קריאה לפונקציה onlyOnMonthDay(day) או onlyOnMonthDays(days).

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

חזרה

RecurrenceRule – ה-RecurrenceRule החדש

אישור

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

`addWeeklyExclusion()`

הוספת כלל שמחריג אירועים שקרו על בסיס שבועי.

כברירת מחדל, ההחרגה חלה באותו יום בשבוע שבו מתקיים האירוע הראשון בסדרה, אבל אפשר לשנות זאת באמצעות קריאה לפונקציה onlyOnWeekday(day) או 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 החדש

אישור

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

`addWeeklyRule()`

הוספת כלל שגורם לאירוע לחזור על עצמו על בסיס שבועי.

כברירת מחדל, האירוע חוזר על עצמו באותו יום בשבוע שבו מתרחש האירוע הראשון בסדרה, אבל אפשר לשנות זאת באמצעות קריאה ל-onlyOnWeekday(day) או ל-onlyOnWeekdays(days).

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

חזרה

RecurrenceRule – ה-RecurrenceRule החדש

אישור

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

`addYearlyExclusion()`

הוספת כלל להחרגת אירועים שנערכים על בסיס שנתי.

כברירת מחדל, ההחרגה חלה באותו יום בשנה שבו מתקיים האירוע הראשון בסדרה, אבל אפשר לשנות זאת באמצעות קריאה לפונקציה onlyOnYearDay(day) או onlyOnYearDays(days).

חזרה

RecurrenceRule – ה-RecurrenceRule החדש

אישור

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

`addYearlyRule()`

הוספת כלל שגורם לאירוע לחזור על עצמו מדי שנה.

כברירת מחדל, האירוע חוזר על עצמו באותו יום בשנה שבו התקיים האירוע הראשון בסדרה, אבל אפשר לשנות זאת באמצעות קריאה ל-onlyOnYearDay(day) או ל-onlyOnYearDays(days).

חזרה

RecurrenceRule – ה-RecurrenceRule החדש

אישור

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

`interval(interval)`

ההגדרה קובעת שהכלל יחול רק במרווח הזמן הזה ביחידה הזמן של הכלל.

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

פרמטרים

שם	סוג	תיאור
`interval`	`Integer`	המרווח ביחידת הזמן של הכלל

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyInMonth(month)`

הגדרת הכלל כך שיחול רק על חודש ספציפי.

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

פרמטרים

שם	סוג	תיאור
`month`	`Month`	החודש

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyInMonths(months)`

הגדרת הכלל כך שיחול רק על חודשים ספציפיים.

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

פרמטרים

שם	סוג	תיאור
`months`	`Month[]`	החודשים

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnMonthDay(day)`

הגדרת הכלל כך שיחול רק על יום ספציפי בחודש.

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

פרמטרים

שם	סוג	תיאור
`day`	`Integer`	היום בחודש

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnMonthDays(days)`

הגדרת הכלל כך שיחול רק על ימים ספציפיים בחודש.

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

פרמטרים

שם	סוג	תיאור
`days`	`Integer[]`	הימים בחודש

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnWeek(week)`

מגדירים את הכלל כך שיחול רק על שבוע ספציפי בשנה.

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

פרמטרים

שם	סוג	תיאור
`week`	`Integer`	השבוע

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnWeekday(day)`

מגדירים את הכלל כך שיחול רק על יום ספציפי בשבוע.

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

פרמטרים

שם	סוג	תיאור
`day`	`Weekday`	היום בשבוע

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnWeekdays(days)`

מגדירים את הכלל כך שיחול רק על ימים ספציפיים בשבוע.

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

פרמטרים

שם	סוג	תיאור
`days`	`Weekday[]`	ימי השבוע

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnWeeks(weeks)`

מגדירים את הכלל כך שיחול רק על שבועות ספציפיים בשנה.

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

פרמטרים

שם	סוג	תיאור
`weeks`	`Integer[]`	השבועות

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnYearDay(day)`

מגדירים את הכלל כך שיחול רק על יום ספציפי בשנה.

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

פרמטרים

שם	סוג	תיאור
`day`	`Integer`	היום בשנה

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`onlyOnYearDays(days)`

מגדירים את הכלל כך שיחול רק על ימים ספציפיים בשנה.

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

פרמטרים

שם	סוג	תיאור
`days`	`Integer[]`	הימים בשנה

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`setTimeZone(timeZone)`

הגדרת אזור הזמן של החזרה. הבחירה הזו משפיעה על התאריך והשעה שבהם האירועים חוזרים, ועל כך שהאירוע ישתנה בהתאם לשעון הקיץ. ברירת המחדל היא אזור הזמן של היומן.

פרמטרים

שם	סוג	תיאור
`timeZone`	`String`	אזור הזמן, שצוין בפורמט 'ארוך' (למשל, 'America/New_York', כפי שמופיע ב-Joda.org)

חזרה

EventRecurrence – האירוע הזה של EventRecurrence לשרשור

אישור

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

`times(times)`

הגדרת הכלל כך שיסתיים אחרי מספר נתון של אירועים.

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

פרמטרים

שם	סוג	תיאור
`times`	`Integer`	מספר הפעמים לחזור על הפעולה

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

`until(endDate)`

הגדרת הכלל כך שיסתיים בתאריך נתון (כולל).

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

פרמטרים

שם	סוג	תיאור
`endDate`	`Date`

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור

אישור

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

`weekStartsOn(day)`

הגדרת היום שבו השבוע מתחיל, לצורך החלת הכלל.

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

פרמטרים

שם	סוג	תיאור
`day`	`Weekday`	היום שבו השבוע מתחיל

חזרה

RecurrenceRule — הכלל RecurrenceRule הזה לשרשור