يمثل قاعدة تكرار لسلسلة أحداث.
تجدُر الإشارة إلى أنّ هذه الفئة تتصرف أيضًا مثل 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
: قاعدة التكرار الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة التكرار الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDate(date)
لإضافة قاعدة تؤدي إلى تكرار الحدث في تاريخ محدد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
date | Date |
استرجاع الكرة
EventRecurrence
— تكرار الحدث هذا للتسلسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addDateExclusion(date)
لإضافة قاعدة تستثني حدثًا لتاريخ محدَّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
date | Date |
استرجاع الكرة
EventRecurrence
— تكرار الحدث هذا للتسلسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addMonthlyExclusion()
تضيف قاعدة تستبعد مواضع الورود على أساس شهري.
يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الشهر الذي يتم فيه تطبيق الحدث الأول في
سلسلة الكتب، ولكن يمكن تغيير ذلك من خلال طلب الرمز onlyOnMonthDay(day)
أو onlyOnMonthDays(days)
.
استرجاع الكرة
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
: قاعدة التكرار الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة التكرار الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات 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
: قاعدة التكرار الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyExclusion()
لإضافة قاعدة تستبعد التكرارات سنويًا.
يتم تلقائيًا تطبيق الاستثناء في اليوم نفسه من السنة الذي يتم فيه تطبيق الحدث الأول في
سلسلة الكتب، ولكن يمكن تعديل هذا الإعداد من خلال طلب الرمز onlyOnYearDay(day)
أو onlyOnYearDays(days)
.
استرجاع الكرة
RecurrenceRule
: قاعدة التكرار الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة تطبيقات REST ذات الصلة:
-
https://www.googleapis.com/auth/calendar
-
https://www.google.com/calendar/feeds
addYearlyRule()
إضافة قاعدة تؤدي إلى تكرار الحدث سنويًا
يتكرر الحدث تلقائيًا في اليوم نفسه من السنة الذي يقع فيه أول حدث في سلسلة الأحداث،
ولكن يمكن تعديل هذا من خلال طلب الرمز onlyOnYearDay(day)
أو onlyOnYearDays(days)
.
استرجاع الكرة
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
interval | Integer | الفاصل الزمني في الوحدة الزمنية للقاعدة |
استرجاع الكرة
RecurrenceRule
— قاعدة التكرار هذه للتسلسل
onlyInMonth(month)
تعمل هذه السياسة على ضبط القاعدة بحيث يتم تطبيقها على شهر معيّن فقط.
// Creates a rule that recurs every week in February. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyInMonth(CalendarApp.Month.FEBRUARY);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
days | Integer[] | أيام الشهر |
استرجاع الكرة
RecurrenceRule
— قاعدة التكرار هذه للتسلسل
onlyOnWeek(week)
تعمل هذه السياسة على ضبط القاعدة بحيث لا يتم تطبيقها إلا على أسبوع معيّن من السنة.
// Creates a rule that recurs on the fifth week of every year. var recurrence = CalendarApp.newRecurrence().addWeeklyRule().onlyOnWeek(5);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
week | Integer | الأسبوع |
استرجاع الكرة
RecurrenceRule
— قاعدة التكرار هذه للتسلسل
onlyOnWeekday(day)
تعمل هذه السياسة على ضبط القاعدة بحيث يتم تطبيقها على يوم معيّن من الأسبوع فقط.
// Creates a rule that recurs every week on Wednesdays. var recurrence = CalendarApp.newRecurrence() .addWeeklyRule().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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]);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
days | Integer[] | أيام السنة |
استرجاع الكرة
RecurrenceRule
— قاعدة التكرار هذه للتسلسل
setTimeZone(timeZone)
لتعيين المنطقة الزمنية لهذا التكرار. ويؤثر هذا على تاريخ ووقت تكرار الأحداث، وما إذا كان الحدث يتغير مع التوقيت الصيفي. يتم ضبط المنطقة الزمنية للتقويم تلقائيًا على المنطقة الزمنية.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
timeZone | String | المنطقة الزمنية المحددة بتنسيق "طويل" (على سبيل المثال، "America/New_York"، كما هو موضّح في Joda.org) |
استرجاع الكرة
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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'));
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
day | Weekday | اليوم الذي يبدأ فيه الأسبوع |
استرجاع الكرة
RecurrenceRule
— قاعدة التكرار هذه للتسلسل