Class ClockTriggerBuilder

ClockTriggerBuilder

Builder untuk pemicu jam.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
after(durationMilliseconds)ClockTriggerBuilderMenentukan durasi minimum (dalam milidetik) setelah waktu saat ini saat pemicu dijalankan.
at(date)ClockTriggerBuilderMenentukan kapan pemicu berjalan.
atDate(year, month, day)ClockTriggerBuilderMenentukan bahwa pemicu diaktifkan pada tanggal yang ditentukan, secara default mendekati tengah malam (+/- 15 menit).
atHour(hour)ClockTriggerBuilderMenentukan jam pemicu saat pemicu berjalan.
create()TriggerMembuat pemicu.
everyDays(n)ClockTriggerBuilderMenentukan untuk menjalankan pemicu setiap n hari.
everyHours(n)ClockTriggerBuilderMenentukan untuk menjalankan pemicu setiap n jam.
everyMinutes(n)ClockTriggerBuilderMenentukan untuk menjalankan pemicu setiap n menit.
everyWeeks(n)ClockTriggerBuilderMenentukan untuk menjalankan pemicu setiap n minggu.
inTimezone(timezone)ClockTriggerBuilderMenentukan zona waktu untuk tanggal/waktu yang ditentukan saat pemicu dijalankan.
nearMinute(minute)ClockTriggerBuilderMenentukan menit saat pemicu berjalan (plus atau minus 15 menit).
onMonthDay(day)ClockTriggerBuilderMenentukan tanggal dalam sebulan saat pemicu dijalankan.
onWeekDay(day)ClockTriggerBuilderMenentukan hari dalam seminggu saat pemicu dijalankan.

Dokumentasi mendetail

after(durationMilliseconds)

Menentukan durasi minimum (dalam milidetik) setelah waktu saat ini saat pemicu dijalankan. Durasi sebenarnya mungkin bervariasi, tetapi tidak akan kurang dari minimum yang Anda tentukan. 

// Creates a trigger that runs 10 minutes later
ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();

Parameter

NamaJenisDeskripsi
durationMillisecondsIntegerDurasi minimum (dalam milidetik) setelah waktu saat ini saat pemicu harus dijalankan.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

at(date)

Menentukan kapan pemicu berjalan. 

// Creates a trigger for December 1, 2012
const triggerDay = new Date(2012, 11, 1);
ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();

Parameter

NamaJenisDeskripsi
dateDateObjek Date yang mewakili kapan pemicu harus dijalankan.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

atDate(year, month, day)

Menentukan bahwa pemicu diaktifkan pada tanggal yang ditentukan, secara default mendekati tengah malam (+/- 15 menit). 

// Schedules for January 1st, 2013
ScriptApp.newTrigger('myFunction').timeBased().atDate(2013, 1, 1).create();

Parameter

NamaJenisDeskripsi
yearIntegerTahun kalender untuk menjadwalkan pemicu.
monthIntegerBulan kalender untuk menjadwalkan pemicu (harus berupa angka antara 1 dan 12, inklusif).
dayIntegerHari kalender untuk menjadwalkan pemicu (harus berupa angka antara 1 dan 31, inklusif).

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

atHour(hour)

Menentukan jam pemicu saat pemicu berjalan. 

// 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();

Parameter

NamaJenisDeskripsi
hourIntegerJam saat akan diaktifkan.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

create()

Membuat pemicu.

Pulang pergi

Trigger — Pemicu terjadwal yang baru dibuat.

everyDays(n)

Menentukan untuk menjalankan pemicu setiap n hari. 

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

Parameter

NamaJenisDeskripsi
nIntegerJumlah hari antara eksekusi.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

everyHours(n)

Menentukan untuk menjalankan pemicu setiap n jam. 

ScriptApp.newTrigger('myFunction').timeBased().everyHours(12).create();

Parameter

NamaJenisDeskripsi
nIntegerJumlah jam di antara eksekusi.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

everyMinutes(n)

Menentukan untuk menjalankan pemicu setiap n menit. n harus 1, 5, 10, 15, atau 30. 

ScriptApp.newTrigger('myFunction').timeBased().everyMinutes(10).create();

Parameter

NamaJenisDeskripsi
nIntegerJumlah menit di antara eksekusi.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

everyWeeks(n)

Menentukan untuk menjalankan pemicu setiap n minggu. 

ScriptApp.newTrigger('myFunction')
    .timeBased()
    .everyWeeks(2)
    .onWeekDay(ScriptApp.WeekDay.FRIDAY)
    .create();

Parameter

NamaJenisDeskripsi
nIntegerJumlah minggu antara eksekusi.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

inTimezone(timezone)

Menentukan zona waktu untuk tanggal/waktu yang ditentukan saat pemicu dijalankan. Secara default, zona waktunya adalah zona waktu skrip.

Daftar string zona waktu yang valid sesuai dengan string zona waktu yang valid yang tercantum oleh Joda.org. String zona waktu yang tidak valid menyebabkan skrip menampilkan error. 

// 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();

Parameter

NamaJenisDeskripsi
timezoneStringZona waktu yang digunakan untuk memperlakukan informasi waktu dalam peristiwa.

Pulang pergi

ClockTriggerBuilder — ClockTriggerBuilder ini, untuk perantaian.

nearMinute(minute)

Menentukan menit saat pemicu berjalan (plus atau minus 15 menit). Jika nearMinute() tidak dipanggil, nilai menit acak akan digunakan. 

// 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();

Parameter

NamaJenisDeskripsi
minuteIntegerMenit saat akan diaktifkan.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

onMonthDay(day)

Menentukan tanggal dalam sebulan saat pemicu dijalankan. 

// Schedules for the first of every month
ScriptApp.newTrigger('myFunction').timeBased().onMonthDay(1).create();

Parameter

NamaJenisDeskripsi
dayIntegerHari dalam sebulan saat pemicu harus dijadwalkan.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.

onWeekDay(day)

Menentukan hari dalam seminggu saat pemicu dijalankan. 

ScriptApp.newTrigger('myFunction')
    .timeBased()
    .onWeekDay(ScriptApp.WeekDay.FRIDAY)
    .create();

Parameter

NamaJenisDeskripsi
dayWeekdayHari dalam seminggu untuk diaktifkan.

Pulang pergi

ClockTriggerBuilder — Builder, untuk pengaitan.