Class ClockTriggerBuilder

حداقل مدت زمان (بر حسب میلی ثانیه) را پس از زمان فعلی که ماشه اجرا می کند، مشخص می کند. مدت زمان واقعی ممکن است متفاوت باشد، اما کمتر از حداقل تعیین شده شما نخواهد بود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

مشخص می کند که ماشه چه زمانی اجرا شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

مشخص می کند که ماشه در تاریخ معین، به طور پیش فرض نزدیک نیمه شب (+/- 15 دقیقه) فعال می شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

ساعتی را مشخص می کند که ماشه در آن تریگر اجرا می شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

ماشه را ایجاد می کند.

بازگشت

Trigger - ماشه تازه ایجاد شده و برنامه ریزی شده.

مشخص می کند که تریگر هر n روز یکبار اجرا شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

مشخص می کند که تریگر هر n ساعت یکبار اجرا شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

مشخص می کند که ماشه هر n دقیقه یکبار اجرا شود. n باید 1، 5، 10، 15 یا 30 باشد.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

مشخص می کند که تریگر هر n هفته یکبار اجرا شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

منطقه زمانی را برای تاریخ‌ها/زمان‌های مشخص شده زمانی که تریگر اجرا می‌شود، مشخص می‌کند. به طور پیش فرض، منطقه زمانی مربوط به اسکریپت است.

فهرست رشته‌های منطقه زمانی معتبر با رشته‌های منطقه زمانی معتبر فهرست‌شده توسط 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();

پارامترها

بازگشت

ClockTriggerBuilder - این ClockTriggerBuilder ، برای زنجیر کردن.

دقیقه ای را که در آن ماشه کار می کند (به اضافه یا منهای 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();

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

تاریخ در ماه اجرا شدن تریگر را مشخص می کند.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.

روزی از هفته را مشخص می کند که ماشه اجرا می شود.

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

پارامترها

بازگشت

ClockTriggerBuilder - سازنده، برای زنجیر کردن.