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 saatten 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 bir yerde (+/- 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 her 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 | Tetikleyici çalıştığında belirtilen tarihler/saat için saat dilimini belirtir. |
nearMinute(minute) | ClockTriggerBuilder | Tetikleyicinin çalıştırılacağı dakikayı (artı veya eksi 15 dakika) belirtir. |
onMonthDay(day) | ClockTriggerBuilder | Tetikleyicinin çalıştığı ayda tarihi belirtir. |
onWeekDay(day) | ClockTriggerBuilder | Tetikleyicinin çalıştığı haftanın gününü belirtir. |
Ayrıntılı belgeler
after(durationMilliseconds)
Tetikleyicinin çalıştığı geçerli saatten sonraki minimum süreyi (milisaniye cinsinden) belirtir. Gerçek süre değişiklik gösterebilir ancak belirttiğiniz minimum süreden kısa olmaz.
// 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 | Tetikleyicinin çalışması gereken geçerli zamandan sonraki minimum süre (milisaniye cinsinden). |
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 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 bir yerde (+/- 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 (1 ve 12 dahil) bir sayı olmalıdır. |
day | Integer | Tetikleyicinin planlanacağı takvim günü (1 ile 31 arasında (1 ve 31 dahil) bir sayı olmalıdır. |
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 | Ateş etme saati. |
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 her 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ütme işlemleri 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ütme işlemleri arasındaki hafta sayısı. |
Return
ClockTriggerBuilder
: Zincirleme için oluşturucu.
inTimezone(timezone)
Tetikleyici çalıştığında belirtilen tarihler/saat için saat dilimini belirtir. Saat dilimi, varsayılan olarak komut dosyasının 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ırılacağı dakikayı (artı veya eksi 15 dakika) belirtir. 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 | Tetiklenme zamanı. |
Return
ClockTriggerBuilder
: Zincirleme için oluşturucu.
onMonthDay(day)
Tetikleyicinin çalıştığı ayda 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ü. |
Return
ClockTriggerBuilder
: Zincirleme için oluşturucu.
onWeekDay(day)
Tetikleyicinin çalıştığı haftanın gününü belirtir.
ScriptApp.newTrigger("myFunction") .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
day | Weekday | Haftanın tetiklenme günü. |
Return
ClockTriggerBuilder
: Zincirleme için oluşturucu.