Class ClockTriggerBuilder

Trình tạo trình kích hoạt Clock

Trình tạo cho các trình kích hoạt đồng hồ.

Phương pháp

Phương thứcLoại dữ liệu trả vềMô tả ngắn
after(durationMilliseconds)ClockTriggerBuilderChỉ định thời lượng tối thiểu (tính bằng mili giây) sau thời gian hiện tại mà trình kích hoạt chạy.
at(date)ClockTriggerBuilderChỉ định thời điểm trình kích hoạt chạy.
atDate(year, month, day)ClockTriggerBuilderChỉ định rằng trình kích hoạt sẽ kích hoạt vào một ngày nhất định theo mặc định, gần nửa đêm (+/- 15 phút).
atHour(hour)ClockTriggerBuilderChỉ định giờ mà trình kích hoạt chạy.
create()TriggerTạo trình kích hoạt.
everyDays(n)ClockTriggerBuilderChỉ định chạy trình kích hoạt n ngày một lần.
everyHours(n)ClockTriggerBuilderChỉ định chạy trình kích hoạt này n giờ một lần.
everyMinutes(n)ClockTriggerBuilderChỉ định chạy trình kích hoạt này n phút một lần.
everyWeeks(n)ClockTriggerBuilderChỉ định chạy trình kích hoạt này n tuần một lần.
inTimezone(timezone)ClockTriggerBuilderChỉ định múi giờ cho ngày/giờ được chỉ định khi trình kích hoạt chạy.
nearMinute(minute)ClockTriggerBuilderChỉ định phút mà trình kích hoạt chạy (cộng hoặc trừ 15 phút).
onMonthDay(day)ClockTriggerBuilderChỉ định ngày trong tháng mà trình kích hoạt chạy.
onWeekDay(day)ClockTriggerBuilderChỉ định ngày trong tuần mà trình kích hoạt chạy.

Tài liệu chi tiết

after(durationMilliseconds)

Chỉ định thời lượng tối thiểu (tính bằng mili giây) sau thời gian hiện tại mà trình kích hoạt chạy. Thời lượng thực tế có thể thay đổi, nhưng sẽ không nhỏ hơn mức tối thiểu mà bạn đã chỉ định. 

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

Các tham số

TênLoạiMô tả
durationMillisecondsIntegerThời lượng tối thiểu (tính bằng mili giây) sau thời điểm hiện tại khi trình kích hoạt sẽ chạy.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

at(date)

Chỉ định thời điểm trình kích hoạt chạy. 

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

Các tham số

TênLoạiMô tả
dateDateĐối tượng Ngày tượng trưng cho thời điểm trình kích hoạt sẽ chạy.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

atDate(year, month, day)

Chỉ định rằng trình kích hoạt sẽ kích hoạt vào một ngày nhất định theo mặc định, gần nửa đêm (+/- 15 phút). 

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

Các tham số

TênLoạiMô tả
yearIntegerNăm dương lịch để lên lịch cho trình kích hoạt.
monthIntegerTháng dương lịch để lên lịch cho trình kích hoạt (phải là một số từ 1 đến 12).
dayIntegerNgày dương lịch để lên lịch cho trình kích hoạt (phải là một số từ 1 đến 31).

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

atHour(hour)

Chỉ định giờ mà trình kích hoạt chạy. 

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

Các tham số

TênLoạiMô tả
hourIntegerGiờ sẽ kích hoạt.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

create()

Tạo trình kích hoạt.

Hai chiều

Trigger — Trình kích hoạt mới được tạo, được lên lịch.

everyDays(n)

Chỉ định chạy trình kích hoạt n ngày một lần. 

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

Các tham số

TênLoạiMô tả
nIntegerSố ngày giữa các lần thực thi.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

everyHours(n)

Chỉ định chạy trình kích hoạt này n giờ một lần. 

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

Các tham số

TênLoạiMô tả
nIntegerSố giờ giữa các lần thực thi.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

everyMinutes(n)

Chỉ định chạy trình kích hoạt này n phút một lần. n phải là 1, 5, 10, 15 hoặc 30. 

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

Các tham số

TênLoạiMô tả
nIntegerSố phút giữa các lần thực thi.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

everyWeeks(n)

Chỉ định chạy trình kích hoạt này n tuần một lần. 

ScriptApp.newTrigger("myFunction")
  .timeBased()
  .everyWeeks(2)
  .create();

Các tham số

TênLoạiMô tả
nIntegerSố tuần giữa các lần thực thi.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

inTimezone(timezone)

Chỉ định múi giờ cho ngày/giờ được chỉ định khi trình kích hoạt chạy. Theo mặc định, múi giờ là múi giờ của tập lệnh.

Danh sách chuỗi múi giờ hợp lệ tương ứng với các chuỗi múi giờ hợp lệ được liệt kê trên Joda.org. Chuỗi múi giờ không hợp lệ khiến tập lệnh tạo ra lỗi. 

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

Các tham số

TênLoạiMô tả
timezoneStringMúi giờ dùng để xử lý thông tin về thời gian trong sự kiện.

Hai chiều

ClockTriggerBuilder – ClockTriggerBuilder này, để xâu chuỗi.

nearMinute(minute)

Chỉ định phút mà trình kích hoạt chạy (cộng hoặc trừ 15 phút). Nếu không gọi nearMinute(), thì giá trị phút ngẫu nhiên sẽ được sử dụng. 

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

Các tham số

TênLoạiMô tả
minuteIntegerPhút để kích hoạt.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

onMonthDay(day)

Chỉ định ngày trong tháng mà trình kích hoạt chạy. 

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

Các tham số

TênLoạiMô tả
dayIntegerNgày trong tháng mà trình kích hoạt sẽ được lên lịch.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.

onWeekDay(day)

Chỉ định ngày trong tuần mà trình kích hoạt chạy. 

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

Các tham số

TênLoạiMô tả
dayWeekdayNgày trong tuần cần kích hoạt.

Hai chiều

ClockTriggerBuilder – Trình tạo để tạo chuỗi.