Saat tetikleyicileri için bir oluşturucu.
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
after(durationMilliseconds) | Clock | Tetikleyicinin çalışacağı, geçerli zamandan sonraki minimum süreyi (milisaniye cinsinden) belirtir. |
at(date) | Clock | Tetikleyicinin ne zaman çalışacağını belirtir. |
at | Clock | Tetikleyicinin, belirtilen tarihte varsayılan olarak gece yarısına yakın bir zamanda (+/- 15 dakika) tetikleneceğini belirtir. |
at | Clock | Tetikleyicinin çalışacağı saati belirtir. |
create() | Trigger | Tetikleyiciyi oluşturur. |
every | Clock | Tetikleyicinin her n günde bir çalıştırılacağını belirtir. |
every | Clock | Tetikleyicinin her n saatte bir çalıştırılacağını belirtir. |
every | Clock | Tetikleyicinin her n dakikada bir çalıştırılacağını belirtir. |
every | Clock | Tetikleyicinin her n haftada bir çalıştırılacağını belirtir. |
in | Clock | Tetikleyicinin çalıştığı belirtilen tarihler/saat için saat dilimini belirtir. |
near | Clock | Tetikleyicinin çalışacağı dakikayı belirtir (artı veya eksi 15 dakika). |
on | Clock | Tetikleyicinin ay içinde çalışacağı tarihi belirtir. |
on | Clock | Tetikleyicinin çalışacağı haftanın gününü belirtir. |
Ayrıntılı belgeler
after(durationMilliseconds)
Tetikleyicinin çalışacağı, geçerli zamandan sonraki minimum süreyi (milisaniye cinsinden) belirtir. Gerçek süre değişebilir 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 |
|---|---|---|
duration | Integer | Tetikleyicinin çalışması gereken, mevcut saatten 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 const 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 gösteren bir Date 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 zamanda (+/- 15 dakika) tetikleneceğ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, bu sayılar dahil). |
day | Integer | Tetikleyicinin planlanacağı takvim günü (1 ile 31 arasında 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şleneceği saat. |
Return
ClockTriggerBuilder: Zincirleme için oluşturucu.
create()
everyDays(n)
Tetikleyicinin her 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 her 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 her 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, komut dosyasının saat dilimidir.
Geçerli saat dilimi dizelerinin listesi, Joda.org tarafından listelenen geçerli saat dilimi dizeleriyle eşleşir. 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 hangi saat dilimine göre değerlendirileceği. |
Return
ClockTriggerBuilder: Zincirleme için bu ClockTriggerBuilder.
nearMinute(minute)
Tetikleyicinin çalışacağı 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 | Ateşleneceği dakika. |
Return
ClockTriggerBuilder — Zincirleme için oluşturucu.
onMonthDay(day)
Tetikleyicinin ay içinde çalışacağı 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 planlanacağı ayın günü. |
Return
ClockTriggerBuilder — Zincirleme için oluşturucu.
onWeekDay(day)
Tetikleyicinin çalışacağı haftanın gününü belirtir.
ScriptApp.newTrigger('myFunction') .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
day | Weekday | Tetikleneceği haftanın günü. |
Return
ClockTriggerBuilder — Zincirleme için oluşturucu.