Class RecurrenceRule

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 — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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 — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

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

addDate(date)

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

פרמטרים

שםסוגתיאור
dateDate

חזרה

‫EventRecurrence — this EventRecurrence for chaining

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

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

addDateExclusion(date)

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

פרמטרים

שםסוגתיאור
dateDate

חזרה

‫EventRecurrence — this EventRecurrence for chaining

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

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

addMonthlyExclusion()

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

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

חזרה

‫RecurrenceRule — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

חזרה

‫RecurrenceRule — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const recurrence = CalendarApp.newRecurrence()
                       .addDailyRule()
                       .addWeeklyExclusion()
                       .onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY)
                       .times(4);

חזרה

‫RecurrenceRule — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().times(10);

חזרה

‫RecurrenceRule — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

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

addYearlyExclusion()

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

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

חזרה

‫RecurrenceRule — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

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

addYearlyRule()

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

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

חזרה

‫RecurrenceRule — the new RecurrenceRule

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-API בארכיטקטורת REST שקשור:

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

פרמטרים

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

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור

onlyInMonth(month)

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

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור

onlyOnWeek(week)

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

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

פרמטרים

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

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור

onlyOnWeekday(day)

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

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור

onlyOnYearDay(day)

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

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

פרמטרים

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

חזרה

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

פרמטרים

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

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור

setTimeZone(timeZone)

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

פרמטרים

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

חזרה

‫EventRecurrence — this EventRecurrence for chaining

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

פרמטרים

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

חזרה

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

פרמטרים

שםסוגתיאור
endDateDate

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור

אישור

סקריפטים שמשתמשים ב-method הזה צריכים הרשאה עם אחת או יותר מהיקפים הבאים או היקפים מתאימים מה-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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().weekStartsOn(
    CalendarApp.Weekday.MONDAY);

פרמטרים

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

חזרה

‫RecurrenceRule – RecurrenceRule הזה לשרשור