Class ClockTriggerBuilder

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

المَعلمات

الاسمTypeالوصف
durationMillisecondsIntegerتمثّل هذه السمة الحد الأدنى للمدة (بالمللي ثانية) بعد الوقت الحالي الذي يجب فيه تشغيل المشغِّل.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


at(date)

تُحدِّد هذه السياسة وقت تشغيل المشغِّل.

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

المَعلمات

الاسمTypeالوصف
dateDateيشير ذلك المصطلح إلى كائن "تاريخ" يمثّل وقت تشغيل المشغّل.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


atDate(year, month, day)

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

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

المَعلمات

الاسمTypeالوصف
yearIntegerالسنة التقويمية لجدولة العامل المشغِّل.
monthIntegerالشهر التقويمي لجدولة العامل المشغِّل (يجب أن يكون رقمًا يتراوح بين 1 و12، بشكل شامل).
dayIntegerاليوم التقويمي لجدولة العامل المشغِّل (يجب أن يكون رقمًا يتراوح بين 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();

المَعلمات

الاسمTypeالوصف
hourIntegerالساعة التي ينطلق فيها النشاط.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


create()

ينشئ العامل المشغِّل.

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

Trigger - المشغِّل المُجدوَل الذي تم إنشاؤه حديثًا


everyDays(n)

يتم تحديده لتشغيل عامل التفعيل كل n يوم.

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

المَعلمات

الاسمTypeالوصف
nIntegerعدد الأيام بين عمليات التنفيذ.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


everyHours(n)

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

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

المَعلمات

الاسمTypeالوصف
nIntegerعدد الساعات بين عمليات التنفيذ.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


everyMinutes(n)

يتم تحديده لتشغيل المشغِّل كل n دقيقة. يجب أن تكون قيمة السمة n 1 أو 5 أو 10 أو 15 أو 30.

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

المَعلمات

الاسمTypeالوصف
nIntegerعدد الدقائق بين عمليات التنفيذ.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


everyWeeks(n)

يتم تحديده لتشغيل عامل التفعيل كل n أسبوع.

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

المَعلمات

الاسمTypeالوصف
nIntegerعدد الأسابيع بين عمليات التنفيذ.

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

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

المَعلمات

الاسمTypeالوصف
timezoneStringالمنطقة الزمنية التي يتم بها معالجة معلومات الوقت في الحدث.

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

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

المَعلمات

الاسمTypeالوصف
minuteIntegerالدقيقة التي تنطلق عندها.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


onMonthDay(day)

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

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

المَعلمات

الاسمTypeالوصف
dayIntegerاليوم من الشهر الذي يجب تحديد موعد عامل التشغيل فيه.

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

ClockTriggerBuilder — أداة إنشاء السلاسل


onWeekDay(day)

يحدِّد يوم الأسبوع الذي يتم فيه تشغيل العامل المشغِّل.

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

المَعلمات

الاسمTypeالوصف
dayWeekdayاليوم الذي ينطلق فيه النشاط من الأسبوع

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

ClockTriggerBuilder — أداة إنشاء السلاسل