سازنده برای تریگرهای ساعت.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
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()
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
- سازنده، برای زنجیر کردن.