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 — RecurrenceRule الجديد

التفويض

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

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 — RecurrenceRule الجديد

التفويض

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

`addDate(date)`

تضيف هذه السمة قاعدة تجعل الحدث يتكرّر في تاريخ محدّد.

المَعلمات

الاسم	النوع	الوصف
`date`	`Date`

الإرجاع

‫EventRecurrence — EventRecurrence هذا للسلسلة

التفويض

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

`addDateExclusion(date)`

تضيف هذه السمة قاعدة تستبعد تكرارًا لتاريخ معيّن.

المَعلمات

الاسم	النوع	الوصف
`date`	`Date`

الإرجاع

‫EventRecurrence — EventRecurrence هذا للسلسلة

التفويض

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

`addMonthlyExclusion()`

تضيف هذه السمة قاعدة تستبعد التكرارات على أساس شهري.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من الشهر الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء onlyOnMonthDay(day) أو onlyOnMonthDays(days).

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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 — RecurrenceRule الجديد

التفويض

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 — RecurrenceRule الجديد

التفويض

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 — RecurrenceRule الجديد

التفويض

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

`addYearlyExclusion()`

تضيف هذه السمة قاعدة تستبعد التكرارات على أساس سنوي.

يتم تطبيق الاستثناء تلقائيًا في اليوم نفسه من السنة الذي يقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء onlyOnYearDay(day) أو onlyOnYearDays(days).

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

`addYearlyRule()`

تضيف هذه السمة قاعدة تؤدي إلى تكرار الحدث سنويًا.

يتكرّر الحدث تلقائيًا في اليوم نفسه من السنة الذي وقع فيه الحدث الأول في السلسلة، ولكن يمكن تغيير ذلك من خلال استدعاء onlyOnYearDay(day) أو onlyOnYearDays(days).

الإرجاع

‫RecurrenceRule — RecurrenceRule الجديد

التفويض

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

المَعلمات

الاسم	النوع	الوصف
`interval`	`Integer`	الفاصل الزمني في وحدة الوقت الخاصة بالقاعدة

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

`onlyInMonth(month)`

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

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

المَعلمات

الاسم	النوع	الوصف
`month`	`Month`	الشهر

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`months`	`Month[]`	الأشهر

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`day`	`Integer`	اليوم من الشهر

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`days`	`Integer[]`	أيام الشهر

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

`onlyOnWeek(week)`

يضبط القاعدة بحيث لا تنطبق إلا على أسبوع معيّن من السنة.

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

المَعلمات

الاسم	النوع	الوصف
`week`	`Integer`	الأسبوع

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

`onlyOnWeekday(day)`

يضبط القاعدة بحيث لا تنطبق إلا على يوم معيّن من الأسبوع.

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

المَعلمات

الاسم	النوع	الوصف
`day`	`Weekday`	يوم الأسبوع

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`days`	`Weekday[]`	أيام الأسبوع

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`weeks`	`Integer[]`	الأسابيع

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

`onlyOnYearDay(day)`

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

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

المَعلمات

الاسم	النوع	الوصف
`day`	`Integer`	يوم من العام

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`days`	`Integer[]`	أيام السنة

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

`setTimeZone(timeZone)`

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

المَعلمات

الاسم	النوع	الوصف
`timeZone`	`String`	المنطقة الزمنية، المحدّدة بالتنسيق "الطويل" (على سبيل المثال، America/New_York، كما هو مدرَج في Joda.org)

الإرجاع

‫EventRecurrence — EventRecurrence هذا للسلسلة

التفويض

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

المَعلمات

الاسم	النوع	الوصف
`times`	`Integer`	عدد مرات التكرار

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
`endDate`	`Date`

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

التفويض

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

المَعلمات

الاسم	النوع	الوصف
`day`	`Weekday`	اليوم الذي يبدأ فيه الأسبوع

الإرجاع

‫RecurrenceRule — RecurrenceRule هذا للسلسلة

Class RecurrenceRule تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

مستندات تفصيلية

addDailyExclusion()

الإرجاع

التفويض

addDailyRule()

الإرجاع

التفويض

addDate(date)

المَعلمات

الإرجاع

التفويض

addDateExclusion(date)

المَعلمات

الإرجاع

التفويض

addMonthlyExclusion()

الإرجاع

التفويض

addMonthlyRule()

الإرجاع

التفويض

addWeeklyExclusion()

الإرجاع

التفويض

addWeeklyRule()

الإرجاع

التفويض

addYearlyExclusion()

الإرجاع

التفويض

addYearlyRule()

الإرجاع

التفويض

interval(interval)

المَعلمات

الإرجاع

onlyInMonth(month)

المَعلمات

الإرجاع

onlyInMonths(months)

المَعلمات

الإرجاع

onlyOnMonthDay(day)

المَعلمات

الإرجاع

onlyOnMonthDays(days)

المَعلمات

الإرجاع

onlyOnWeek(week)

المَعلمات

الإرجاع

onlyOnWeekday(day)

المَعلمات

الإرجاع

onlyOnWeekdays(days)

المَعلمات

الإرجاع

onlyOnWeeks(weeks)

المَعلمات

الإرجاع

onlyOnYearDay(day)

المَعلمات

الإرجاع

onlyOnYearDays(days)

المَعلمات

الإرجاع

setTimeZone(timeZone)

المَعلمات

الإرجاع

التفويض

times(times)

المَعلمات

الإرجاع

until(endDate)

المَعلمات

الإرجاع

التفويض

weekStartsOn(day)

Class RecurrenceRule

`addDailyExclusion()`

`addDailyRule()`

`addDate(date)`

`addDateExclusion(date)`

`addMonthlyExclusion()`

`addMonthlyRule()`

`addWeeklyExclusion()`

`addWeeklyRule()`

`addYearlyExclusion()`

`addYearlyRule()`

`interval(interval)`

`onlyInMonth(month)`

`onlyInMonths(months)`

`onlyOnMonthDay(day)`

`onlyOnMonthDays(days)`

`onlyOnWeek(week)`

`onlyOnWeekday(day)`

`onlyOnWeekdays(days)`

`onlyOnWeeks(weeks)`

`onlyOnYearDay(day)`

`onlyOnYearDays(days)`

`setTimeZone(timeZone)`

`times(times)`

`until(endDate)`

`weekStartsOn(day)`