Class RecurrenceRule

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 – כלל החזרה החדש

אישור

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

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

addDate(date)

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

פרמטרים

שםסוגתיאור
dateDate

חזרה

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

אישור

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

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

addDateExclusion(date)

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

פרמטרים

שםסוגתיאור
dateDate

חזרה

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

אישור

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

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

addMonthlyExclusion()

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

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

חזרה

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

אישור

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

  • 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 – כלל החזרה החדש

אישור

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

  • 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 – כלל החזרה החדש

אישור

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

  • 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 – כלל החזרה החדש

אישור

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

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

addYearlyExclusion()

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

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

חזרה

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

אישור

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

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

addYearlyRule()

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

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

חזרה

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

אישור

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

  • 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);

פרמטרים

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

חזרה

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


onlyInMonth(month)

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

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

פרמטרים

שםסוגתיאור
monthMonthהחודש

חזרה

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]);

פרמטרים

שםסוגתיאור
monthsMonth[]החודשים

חזרה

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


onlyOnMonthDay(day)

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

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

פרמטרים

שםסוגתיאור
dayIntegerהיום בחודש

חזרה

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]);

פרמטרים

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

חזרה

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


onlyOnWeek(week)

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

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

פרמטרים

שםסוגתיאור
weekIntegerהשבוע

חזרה

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


onlyOnWeekday(day)

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

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

פרמטרים

שםסוגתיאור
dayWeekdayהיום בשבוע

חזרה

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]);

פרמטרים

שםסוגתיאור
daysWeekday[]הימים בשבוע

חזרה

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]);

פרמטרים

שםסוגתיאור
weeksInteger[]השבועות

חזרה

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


onlyOnYearDay(day)

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

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

פרמטרים

שםסוגתיאור
dayIntegerהיום בשנה

חזרה

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


onlyOnYearDays(days)

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

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

פרמטרים

שםסוגתיאור
daysInteger[]הימים בשנה

חזרה

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


setTimeZone(timeZone)

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

פרמטרים

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

חזרה

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

אישור

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

  • 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);

פרמטרים

שםסוגתיאור
timesIntegerמספר הפעמים

חזרה

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'));

פרמטרים

שםסוגתיאור
endDateDate

חזרה

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

אישור

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

  • 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);

פרמטרים

שםסוגתיאור
dayWeekdayהיום שבו השבוע מתחיל

חזרה

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