Saat tetikleyicileri için bir oluşturucu.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
after(durationMilliseconds) | ClockTriggerBuilder | Tetikleyicinin çalıştığı geçerli zamandan sonraki minimum süreyi (milisaniye cinsinden) belirtir. |
at(date) | ClockTriggerBuilder | Tetikleyicinin ne zaman çalışacağını belirtir. |
atDate(year, month, day) | ClockTriggerBuilder | Tetikleyicinin belirtilen tarihte, varsayılan olarak gece yarısına yakın (+/- 15 dakika) etkinleşeceğini belirtir. |
atHour(hour) | ClockTriggerBuilder | Tetikleyicinin çalışacağı saati belirtir. |
create() | Trigger | Tetikleyiciyi oluşturur. |
everyDays(n) | ClockTriggerBuilder | Tetikleyicinin n günde bir çalıştırılacağını belirtir. |
everyHours(n) | ClockTriggerBuilder | Tetikleyicinin n saatte bir çalıştırılacağını belirtir. |
everyMinutes(n) | ClockTriggerBuilder | Tetikleyicinin n dakikada bir çalıştırılacağını belirtir. |
everyWeeks(n) | ClockTriggerBuilder | Tetikleyicinin n haftada bir çalıştırılacağını belirtir. |
inTimezone(timezone) | ClockTriggerBuilder | Tetikleyicinin çalıştığı belirtilen tarihler/saat için saat dilimini belirtir. |
nearMinute(minute) | ClockTriggerBuilder | Tetikleyicinin çalıştığı dakikayı belirtir (artı veya eksi 15 dakika). |
onMonthDay(day) | ClockTriggerBuilder | Tetikleyicinin çalıştırıldığı ay içindeki tarihi belirtir. |
onWeekDay(day) | ClockTriggerBuilder | Tetikleyicinin çalıştırıldığı haftanın gününü belirtir. |
Ayrıntılı belgeler
after(durationMilliseconds)
Tetikleyicinin çalıştığı geçerli zamandan sonraki minimum süreyi (milisaniye cinsinden) belirtir. Gerçek süre değişiklik gösterebilir ancak belirttiğiniz minimum süreden kısa olamaz.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger("myFunction") .timeBased() .after(10 * 60 * 1000) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
durationMilliseconds | Integer | Geçerli zamandan sonra (milisaniye cinsinden) tetikleyicinin çalışması gerekir. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
at(date)
Tetikleyicinin ne zaman çalışacağını belirtir.
// Creates a trigger for December 1, 2012 var triggerDay = new Date(2012, 11, 1); ScriptApp.newTrigger("myFunction") .timeBased() .at(triggerDay) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
date | Date | Tetikleyicinin ne zaman çalışması gerektiğini temsil eden bir Tarih nesnesi. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
atDate(year, month, day)
Tetikleyicinin belirtilen tarihte, varsayılan olarak gece yarısına yakın (+/- 15 dakika) etkinleşeceğini belirtir.
// Schedules for January 1st, 2013 ScriptApp.newTrigger("myFunction") .timeBased() .atDate(2013, 1, 1) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
year | Integer | Tetikleyicinin planlanacağı takvim yılı. |
month | Integer | Tetikleyicinin planlanacağı takvim ayı (1 ile 12 arasında bir sayı olmalıdır, dahil). |
day | Integer | Tetikleyicinin planlanacağı takvim günü (1 ile 31 arasında bir sayı olmalıdır, dahil). |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
atHour(hour)
Tetikleyicinin çalışacağı saati belirtir.
// 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();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
hour | Integer | Tetiklenecek saat. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
create()
everyDays(n)
Tetikleyicinin n
günde bir çalıştırılacağını belirtir.
ScriptApp.newTrigger("myFunction") .timeBased() .everyDays(3) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
n | Integer | Yürütmeler arasındaki gün sayısı. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
everyHours(n)
Tetikleyicinin n
saatte bir çalıştırılacağını belirtir.
ScriptApp.newTrigger("myFunction") .timeBased() .everyHours(12) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
n | Integer | Yürütmeler arasındaki saat sayısı. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
everyMinutes(n)
Tetikleyicinin n
dakikada bir çalıştırılacağını belirtir. n
1, 5, 10, 15 veya 30 olmalıdır.
ScriptApp.newTrigger("myFunction") .timeBased() .everyMinutes(10) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
n | Integer | Yürütmeler arasındaki dakika sayısı. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
everyWeeks(n)
Tetikleyicinin n
haftada bir çalıştırılacağını belirtir.
ScriptApp.newTrigger("myFunction") .timeBased() .everyWeeks(2) .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
n | Integer | Yürütmeler arasındaki hafta sayısı. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
inTimezone(timezone)
Tetikleyicinin çalıştığı belirtilen tarihler/saat için saat dilimini belirtir. Varsayılan olarak saat dilimi, alfabenin saat dilimidir.
Geçerli saat dilimi dizeleri listesi, Joda.org tarafından listelenen geçerli saat dilimi dizelerine karşılık gelir. Geçersiz bir saat dilimi dizesi komut dosyasının hata vermesine neden olur.
// 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();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timezone | String | Etkinlikteki zaman bilgilerinin ele alınacağı saat dilimi. |
Return
ClockTriggerBuilder
— Bu ClockTriggerBuilder
, zincirleme bağlantı için.
nearMinute(minute)
Tetikleyicinin çalıştığı dakikayı belirtir (artı veya eksi 15 dakika). nearMinute()
çağrılmazsa rastgele bir dakika değeri kullanılır.
// 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();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
minute | Integer | Tetiklenecek dakika. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
onMonthDay(day)
Tetikleyicinin çalıştırıldığı ay içindeki tarihi belirtir.
// Schedules for the first of every month ScriptApp.newTrigger("myFunction") .timeBased() .onMonthDay(1) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
day | Integer | Tetikleyicinin planlanması gereken ayın günüdür. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.
onWeekDay(day)
Tetikleyicinin çalıştırıldığı haftanın gününü belirtir.
ScriptApp.newTrigger("myFunction") .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
day | Weekday | Tetiklenecek haftanın günü. |
Return
ClockTriggerBuilder
— Zincirleme için oluşturucu.