Class RecurrenceRule

قاعدة التكرار

تمثّل قاعدة تكرار لسلسلة أحداث.

تجدر الإشارة إلى أنّ هذه الفئة تتصرف أيضًا مثل EventRecurrence التي تنتمي إليها، مما يتيح لك ربط إنشاء القواعد معًا على النحو التالي: 

const recurrence = CalendarApp.newRecurrence().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.
const 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.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

الإرجاع

‫RecurrenceRule - قاعدة التكرار الجديدة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

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

addDate(date)

تُضيف قاعدة تؤدي إلى تكرار الحدث في تاريخ محدّد.

المعلمات

الاسمالنوعالوصف
dateDate

الإرجاع

‫EventRecurrence — هذا العنصر EventRecurrence لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات REST ذات الصلة:

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

addDateExclusion(date)

تُضيف قاعدة تستبعد مرّة حدوث لتاريخ محدّد.

المعلمات

الاسمالنوعالوصف
dateDate

الإرجاع

‫EventRecurrence — هذا العنصر 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.
const 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.
const 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.
const 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.
const recurrence = CalendarApp.newRecurrence().addWeeklyRule().interval(4);

المعلمات

الاسمالنوعالوصف
intervalIntegerالفاصل الزمني في وحدة الوقت للقاعدة

الإرجاع

RecurrenceRule - قاعدة التكرار هذه لإنشاء سلسلة

onlyInMonth(month)

لضبط القاعدة لتطبيقها على شهر معيّن فقط. 

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

المعلمات

الاسمالنوعالوصف
monthMonthالشهر

الإرجاع

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 - قاعدة التكرار هذه لإنشاء سلسلة

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 - قاعدة التكرار هذه لإنشاء سلسلة

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 - قاعدة التكرار هذه لإنشاء سلسلة

onlyOnWeek(week)

لضبط القاعدة لتطبيقها على أسبوع معيّن من السنة فقط. 

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

المعلمات

الاسمالنوعالوصف
weekIntegerالأسبوع

الإرجاع

RecurrenceRule - قاعدة التكرار هذه لإنشاء سلسلة

onlyOnWeekday(day)

ضبط القاعدة لتطبيقها على يوم معيّن من الأسبوع فقط 

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

المعلمات

الاسمالنوعالوصف
dayWeekdayيوم من الأسبوع

الإرجاع

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 - قاعدة التكرار هذه لإنشاء سلسلة

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 - قاعدة التكرار هذه لإنشاء سلسلة

onlyOnYearDay(day)

لضبط القاعدة لتطبيقها على يوم معيّن من السنة فقط. 

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

المعلمات

الاسمالنوعالوصف
dayIntegerيوم من السنة

الإرجاع

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 - قاعدة التكرار هذه لإنشاء سلسلة

setTimeZone(timeZone)

لضبط المنطقة الزمنية لهذا التكرار ويؤثر ذلك في تاريخ ووقت تكرار الأحداث، وما إذا كان الحدث يتغيّر مع التوقيت الصيفي. يتم ضبطها تلقائيًا على المنطقة الزمنية للتقويم.

المعلمات

الاسمالنوعالوصف
timeZoneStringالمنطقة الزمنية، المحدّدة بالتنسيق "الطولي" (مثل ‎'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.
const recurrence = CalendarApp.newRecurrence().addDailyRule().times(10);

المعلمات

الاسمالنوعالوصف
timesIntegerعدد المرات التي ستتكرر فيها الحملة

الإرجاع

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 - قاعدة التكرار هذه لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن باستخدام واحد أو أكثر من النطاقات التالية أو النطاقات المناسبة من واجهة برمجة التطبيقات 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 - قاعدة التكرار هذه لإنشاء سلسلة