تمت ترجمة هذه الصفحة بواسطة 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
var 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 — أداة الإنشاء للسلاسل