تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class RecurrenceRule

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

تجدُر الإشارة إلى أنّ هذه الفئة تتصرف أيضًا مثل 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: قاعدة التكرار الجديدة

التفويض

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

`addDate(date)`

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

المَعلمات

الاسم	Type	الوصف
`date`	`Date`

استرجاع الكرة

EventRecurrence — تكرار الحدث هذا للتسلسل

التفويض

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

`addDateExclusion(date)`

لإضافة قاعدة تستثني حدثًا لتاريخ محدَّد.

المَعلمات

الاسم	Type	الوصف
`date`	`Date`

استرجاع الكرة

EventRecurrence — تكرار الحدث هذا للتسلسل

التفويض

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

`addMonthlyExclusion()`

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

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

استرجاع الكرة

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.
var recurrence = CalendarApp.newRecurrence().addMonthlyRule().times(4);

استرجاع الكرة

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.
var recurrence = CalendarApp.newRecurrence().addDailyRule()
    .addWeeklyExclusion().onlyOnWeekday(CalendarApp.Weekday.WEDNESDAY).times(4);

استرجاع الكرة

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

استرجاع الكرة

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

التفويض

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

`addYearlyExclusion()`

لإضافة قاعدة تستبعد التكرارات سنويًا.

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

استرجاع الكرة

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

التفويض

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

`addYearlyRule()`

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

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

استرجاع الكرة

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

التفويض

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 — تكرار الحدث هذا للتسلسل

التفويض

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

التفويض

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