يمثل قاعدة تكرار لسلسلة أحداث.
تجدر الإشارة إلى أنّ هذه الفئة تتصرف أيضًا مثل 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDate(date)
إضافة قاعدة تؤدي إلى تكرار الحدث في تاريخ محدد
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date |
الإرجاع
EventRecurrence
— حدث EventRecurrence هذا للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDateExclusion(date)
إضافة قاعدة تستبعد ورودًا لتاريخ محدد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
date | Date |
الإرجاع
EventRecurrence
— حدث EventRecurrence هذا للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addMonthlyExclusion()
إضافة قاعدة تستبعد التكرارات على أساس شهري.
يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الشهر الذي يقع فيه الحدث الأول في
ولكن يمكن تغيير ذلك من خلال طلب الرقم onlyOnMonthDay(day)
أو onlyOnMonthDays(days)
.
الإرجاع
RecurrenceRule
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyExclusion()
تضيف قاعدة تستبعد مواضع الورود سنويًا.
يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من العام الذي يقع فيه الحدث الأول في
ولكن يمكن تغيير ذلك من خلال طلب الرقم onlyOnYearDay(day)
أو onlyOnYearDays(days)
.
الإرجاع
RecurrenceRule
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyRule()
تضيف قاعدة تؤدي إلى تكرار الحدث على أساس سنوي.
بشكل افتراضي، يتكرر الحدث في اليوم نفسه من السنة الذي يقع فيه الحدث الأول في السلسلة،
ولكن يمكن تغيير ذلك من خلال طلب الرقم onlyOnYearDay(day)
أو onlyOnYearDays(days)
.
الإرجاع
RecurrenceRule
: قاعدة RecurrenceRule الجديدة
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
— حدث EventRecurrence هذا للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
— قاعدة التكرار هذه للتسلسل
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
— قاعدة التكرار هذه للتسلسل