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

Class ClockTriggerBuilder

في الساعة

أداة إنشاء لتشغيل المهام استنادًا إلى الساعة

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`after(durationMilliseconds)`	`ClockTriggerBuilder`	تحدّد الحدّ الأدنى لمدة (بالملي ثانية) بعد الوقت الحالي الذي يتم فيه تشغيل المشغِّل.
`at(date)`	`ClockTriggerBuilder`	تُحدِّد وقت تشغيل عامل التفعيل.
`atDate(year, month, day)`	`ClockTriggerBuilder`	يحدِّد هذا الخيار أنّ العامل المشغِّل يتم تفعيله في التاريخ المحدَّد، تلقائيًا بالقرب من منتصف الليل (+/- 15 دقيقة).
`atHour(hour)`	`ClockTriggerBuilder`	تُحدِّد الساعة التي يتم فيها تشغيل عامل التفعيل.
`create()`	`Trigger`	لإنشاء عامل التشغيل
`everyDays(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل عامل التفعيل كل `n` يوم.
`everyHours(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل عامل التفعيل كل `n` ساعة.
`everyMinutes(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل عامل التفعيل كل `n` دقيقة.
`everyWeeks(n)`	`ClockTriggerBuilder`	تُستخدَم لتحديد تشغيل المشغِّل كل `n` أسبوع.
`inTimezone(timezone)`	`ClockTriggerBuilder`	تحدّد المنطقة الزمنية للتواريخ أو الوقت المحدّدَين عند تشغيل المشغّل.
`nearMinute(minute)`	`ClockTriggerBuilder`	تحدِّد الدقيقة التي يتم فيها تشغيل عامل التفعيل (بالإضافة إلى 15 دقيقة أو ناقصها).
`onMonthDay(day)`	`ClockTriggerBuilder`	تحدِّد هذه الوسيطة التاريخ في الشهر الذي يتم فيه تشغيل عامل التفعيل.
`onWeekDay(day)`	`ClockTriggerBuilder`	تُستخدَم لتحديد يوم الأسبوع الذي يتم فيه تشغيل عامل التفعيل.

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

`after(durationMilliseconds)`

تحدّد الحدّ الأدنى لمدة (بالملي ثانية) بعد الوقت الحالي الذي يتم فيه تشغيل العامل المشغِّل. قد تختلف المدة الفعلية، ولكنّها لن تقلّ عن الحدّ الأدنى المحدّد.

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();

المعلَمات

الاسم	النوع	الوصف
`durationMilliseconds`	`Integer`	الحد الأدنى للمدة (بالملي ثانية) بعد الوقت الحالي الذي يجب فيه تشغيل عامل التشغيل

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`at(date)`

تُحدِّد وقت تشغيل عامل التفعيل.

// Creates a trigger for December 1, 2012
const triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();

المعلَمات

الاسم	النوع	الوصف
`date`	`Date`	عنصر تاريخ يمثّل وقت تشغيل عامل التشغيل

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`atDate(year, month, day)`

يحدِّد هذا الخيار أنّ العامل المشغِّل يتم تفعيله في التاريخ المحدَّد، تلقائيًا بالقرب من منتصف الليل (+/- 15 دقيقة).

// Schedules for January 1st, 2013
ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 1, 1).create();

المعلَمات

الاسم	النوع	الوصف
`year`	`Integer`	السنة التقويمية لتحديد موعد التفعيل
`month`	`Integer`	الشهر التقويمي لتحديد موعد تشغيل العامل المشغِّل (يجب أن يكون رقمًا بين 1 و12 بالتضمين).
`day`	`Integer`	يوم التقويم لتحديد موعد التفعيل (يجب أن يكون رقمًا بين 1 و31 بما في ذلك).

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`atHour(hour)`

تُحدِّد الساعة التي يتم فيها تشغيل عامل التفعيل.

// Runs between 5am-6am in the timezone of the script
ScriptApp.newTrigger('myFunction')
    .timeBased()
    .atHour(5)
    .everyDays(
        1)  // Frequency is required if you are using atHour() or nearMinute()
    .create();

المعلَمات

الاسم	النوع	الوصف
`hour`	`Integer`	الساعة التي يتم فيها إطلاق الحملة.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`create()`

لإنشاء عامل التشغيل

الإرجاع

Trigger: عامل التشغيل المجدوَل الذي تم إنشاؤه حديثًا.

`everyDays(n)`

تُستخدَم لتحديد تشغيل عامل التفعيل كل n يوم.

ScriptApp.newTrigger('myFunction').timeBased().everyDays(3).create();

المعلَمات

الاسم	النوع	الوصف
`n`	`Integer`	عدد الأيام بين عمليات التنفيذ

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`everyHours(n)`

تُستخدَم لتحديد تشغيل عامل التفعيل كل n ساعة.

ScriptApp.newTrigger('myFunction').timeBased().everyHours(12).create();

المعلَمات

الاسم	النوع	الوصف
`n`	`Integer`	عدد الساعات بين عمليات التنفيذ

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`everyMinutes(n)`

تُستخدَم لتحديد تشغيل عامل التفعيل كل n دقيقة. يجب أن يكون n 1 أو 5 أو 10 أو 15 أو 30.

ScriptApp.newTrigger('myFunction').timeBased().everyMinutes(10).create();

المعلَمات

الاسم	النوع	الوصف
`n`	`Integer`	عدد الدقائق بين عمليات التنفيذ

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`everyWeeks(n)`

تُستخدَم لتحديد تشغيل المشغِّل كل n أسبوع.

ScriptApp.newTrigger('myFunction')
    .timeBased()
    .everyWeeks(2)
    .onWeekDay(ScriptApp.WeekDay.FRIDAY)
    .create();

المعلَمات

الاسم	النوع	الوصف
`n`	`Integer`	عدد الأسابيع بين عمليات التنفيذ

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`inTimezone(timezone)`

تحدّد المنطقة الزمنية للتواريخ أو الوقت المحدّدَين عند تشغيل المشغّل. تكون المنطقة الزمنية الافتراضية هي المنطقة الزمنية للنص البرمجي.

تتطابق قائمة سلاسل المناطق الزمنية الصالحة مع سلاسل المناطق الزمنية الصالحة التي يعرضها موقع Joda.org. تؤدي سلسلة منطقة زمنية غير صالحة إلى ظهور خطأ في النص البرمجي.

// Schedule the trigger to execute at noon every day in the US/Pacific time zone
ScriptApp.newTrigger('myFunction')
    .timeBased()
    .atHour(12)
    .everyDays(1)
    .inTimezone('America/Los_Angeles')
    .create();

المعلَمات

الاسم	النوع	الوصف
`timezone`	`String`	المنطقة الزمنية التي يتم التعامل بها مع معلومات الوقت في الحدث

الإرجاع

ClockTriggerBuilder — هذا الرمز ClockTriggerBuilder، لإنشاء سلسلة.

`nearMinute(minute)`

تحدِّد الدقيقة التي يتم فيها تشغيل عامل التفعيل (بالإضافة إلى 15 دقيقة أو ناقصها). في حال عدم استدعاء nearMinute()، يتم استخدام قيمة عشوائية للدقائق.

// Runs at approximately 5:30am in the timezone of the script
ScriptApp.newTrigger('myFunction')
    .timeBased()
    .atHour(5)
    .nearMinute(30)
    .everyDays(
        1)  // Frequency is required if you are using atHour() or nearMinute()
    .create();

المعلَمات

الاسم	النوع	الوصف
`minute`	`Integer`	الدقيقة التي يتم فيها إطلاق الحملة.

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`onMonthDay(day)`

تحدِّد هذه السمة التاريخ في الشهر الذي يتم فيه تشغيل عامل التفعيل.

// Schedules for the first of every month
ScriptApp.newTrigger('myFunction').timeBased().onMonthDay(1).create();

المعلَمات

الاسم	النوع	الوصف
`day`	`Integer`	يوم الشهر الذي يجب تحديد المشغّل له

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر

`onWeekDay(day)`

تُستخدَم لتحديد يوم الأسبوع الذي يتم فيه تشغيل عامل التفعيل.

ScriptApp.newTrigger('myFunction')
    .timeBased()
    .onWeekDay(ScriptApp.WeekDay.FRIDAY)
    .create();

المعلَمات

الاسم	النوع	الوصف
`day`	`Weekday`	يوم الأسبوع الذي يتم فيه تشغيل الإجراء

الإرجاع

ClockTriggerBuilder — أداة الإنشاء لتسلسل العناصر