Class ClockTriggerBuilder

ClockTriggerBuilder

Saat tetikleyicileri için bir oluşturucu.

Yöntemler

YöntemDönüş türüKısa açıklama
after(durationMilliseconds)ClockTriggerBuilderTetikleyicinin çalışacağı, geçerli zamandan sonraki minimum süreyi (milisaniye cinsinden) belirtir.
at(date)ClockTriggerBuilderTetikleyicinin ne zaman çalışacağını belirtir.
atDate(year, month, day)ClockTriggerBuilderTetikleyicinin, belirtilen tarihte varsayılan olarak gece yarısına yakın bir zamanda (+/- 15 dakika) tetikleneceğini belirtir.
atHour(hour)ClockTriggerBuilderTetikleyicinin çalışacağı saati belirtir.
create()TriggerTetikleyiciyi oluşturur.
everyDays(n)ClockTriggerBuilderTetikleyicinin her n günde bir çalıştırılacağını belirtir.
everyHours(n)ClockTriggerBuilderTetikleyicinin her n saatte bir çalıştırılacağını belirtir.
everyMinutes(n)ClockTriggerBuilderTetikleyicinin her n dakikada bir çalıştırılacağını belirtir.
everyWeeks(n)ClockTriggerBuilderTetikleyicinin her n haftada bir çalıştırılacağını belirtir.
inTimezone(timezone)ClockTriggerBuilderTetikleyicinin çalıştığı belirtilen tarihler/saat için saat dilimini belirtir.
nearMinute(minute)ClockTriggerBuilderTetikleyicinin çalışacağı dakikayı belirtir (artı veya eksi 15 dakika).
onMonthDay(day)ClockTriggerBuilderTetikleyicinin ay içinde çalışacağı tarihi belirtir.
onWeekDay(day)ClockTriggerBuilderTetikleyicinin ç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

AdTürAçıklama
durationMillisecondsIntegerTetikleyicinin ç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

AdTürAçıklama
dateDateTetikleyicinin 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

AdTürAçıklama
yearIntegerTetikleyicinin planlanacağı takvim yılı.
monthIntegerTetikleyicinin planlanacağı takvim ayı (1 ile 12 arasında bir sayı olmalıdır, bu sayılar dahil).
dayIntegerTetikleyicinin 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

AdTürAçıklama
hourIntegerAteşleneceği saat.

Return

ClockTriggerBuilder: Zincirleme için oluşturucu.


create()

Tetikleyiciyi oluşturur.

Return

Trigger: Yeni oluşturulan, planlanmış tetikleyici.


everyDays(n)

Tetikleyicinin her n günde bir çalıştırılacağını belirtir.

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

Parametreler

AdTürAçıklama
nIntegerYü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

AdTürAçıklama
nIntegerYü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

AdTürAçıklama
nIntegerYü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

AdTürAçıklama
nIntegerYü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

AdTürAçıklama
timezoneStringEtkinlikteki 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

AdTürAçıklama
minuteIntegerAteş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

AdTürAçıklama
dayIntegerTetikleyicinin 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

AdTürAçıklama
dayWeekdayTetikleneceği haftanın günü.

Return

ClockTriggerBuilder — Zincirleme için oluşturucu.