מייצג כלל לחזרה של סדרת אירועים.
שימו לב שהמחלקה הזו מתנהגת גם כמו ה-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)
מוסיף כלל שגורם לאירוע לחזור בתאריך מסוים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
date | Date |
החזרות
EventRecurrence
– חזרה של האירוע הזה לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה עם אחד או יותר מההיקפים הבאים או עם ההיקפים המתאימים מ-API ל-REST הקשור:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDateExclusion(date)
הוספת כלל שלא כולל אירוע בתאריך ספציפי.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
date | Date |
החזרות
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);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
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 | אזור הזמן שצוין בפורמט "ארוך" (למשל, '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);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
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
– הכלל החוזר הזה לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה עם אחד או יותר מההיקפים הבאים או עם ההיקפים המתאימים מ-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);
פרמטרים
שם | תיאור | התיאור |
---|---|---|
day | Weekday | היום שבו השבוע מתחיל |
החזרות
RecurrenceRule
– הכלל החוזר הזה לשרשור