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

Class RecurrenceRule

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

חשוב לזכור שהכיתה הזו גם פועלת כמו EventRecurrence שאליו היא שייכת. וכך אפשר לשרשר את היצירה של כללים, באופן הבא:

recurrence.addDailyRule().times(3).interval(2).addWeeklyExclusion().times(2);

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule().addDailyExclusion().times(30);

חזרה

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.
var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

חזרה

RecurrenceRule – כלל החזרה החדש

אישור

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

`addDate(date)`

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

פרמטרים

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

חזרה

EventRecurrence – חזרה של האירוע הזה ליצירת שרשרת

אישור

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

`addDateExclusion(date)`

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

פרמטרים

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

חזרה

EventRecurrence – חזרה של האירוע הזה ליצירת שרשרת

אישור

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

`addMonthlyExclusion()`

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

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

חזרה

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.
var recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

חזרה

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.
var recurrence = CalendarApp.newRecurrence().addDailyRule()
    .addWeeklyExclusion().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY).times(4);

חזרה

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.
var recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

חזרה

RecurrenceRule – כלל החזרה החדש

אישור

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

`addYearlyExclusion()`

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

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

חזרה

RecurrenceRule – כלל החזרה החדש

אישור

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

`addYearlyRule()`

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

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

חזרה

RecurrenceRule – כלל החזרה החדש

אישור

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

`interval(interval)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyInMonth(month)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyInMonths(months)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnMonthDay(day)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnMonthDays(days)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnWeek(week)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnWeekday(day)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnWeekdays(days)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnWeeks(weeks)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnYearDay(day)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`onlyOnYearDays(days)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`setTimeZone(timeZone)`

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

פרמטרים

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

חזרה

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.
var recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

`until(endDate)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים

אישור

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

`weekStartsOn(day)`

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

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

פרמטרים

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

חזרה

RecurrenceRule – כלל החזרה הזה ליצירת שרשורים