Class ClockTriggerBuilder

ClockTriggerBuilder

Trình tạo kích hoạt đồng hồ.

Phương thức

Phương thứcKiểu 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 điều kiện kích hoạt sẽ kích hoạt vào một ngày nhất định, theo mặc định là gần nửa đêm (+/- 15 phút).
atHour(hour)ClockTriggerBuilderChỉ định giờ mà trình kích hoạt này chạy.
create()TriggerTạo điều kiện kích hoạt.
everyDays(n)ClockTriggerBuilderChỉ định chạy điều kiện kích hoạt n ngày một lần.
everyHours(n)ClockTriggerBuilderChỉ định chạy điều kiện kích hoạt n giờ một lần.
everyMinutes(n)ClockTriggerBuilderChỉ định chạy điều kiện kích hoạt n phút một lần.
everyWeeks(n)ClockTriggerBuilderChỉ định chạy điều kiện kích hoạt 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 số 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ể khác, nhưng sẽ không ít hơn thời lượng tối thiểu 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ạiNội dung mô 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 điều kiện kích hoạt sẽ chạy.

Cầu thủ trả bóng

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ạiNội dung mô tả
dateDateĐối tượng Ngày biểu thị thời điểm nên chạy trình kích hoạt.

Cầu thủ trả bóng

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

atDate(year, month, day)

Chỉ định rằng điều kiện kích hoạt sẽ kích hoạt vào một ngày nhất định, theo mặc định là 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ạiNội dung mô tả
yearIntegerNăm dương lịch để lên lịch điều kiện kích hoạt.
monthIntegerTháng theo lịch để lên lịch điều kiện kích hoạt (phải là một số từ 1 đến 12).
dayIntegerNgày theo lịch để lên lịch điều kiện kích hoạt (phải là một số từ 1 đến 31).

Cầu thủ trả bóng

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

atHour(hour)

Chỉ định giờ mà trình kích hoạt này 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ạiNội dung mô tả
hourIntegerGiờ kích hoạt.

Cầu thủ trả bóng

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

create()

Tạo điều kiện kích hoạt.

Cầu thủ trả bóng

Trigger – Trình kích hoạt mới được tạo và theo lịch.

everyDays(n)

Chỉ định chạy điều kiện kích hoạt n ngày một lần. 

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

Các tham số

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

Cầu thủ trả bóng

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

everyHours(n)

Chỉ định chạy điều kiện kích hoạt n giờ một lần. 

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

Các tham số

TênLoạiNội dung mô tả
nIntegerSố giờ giữa các lần thực thi.

Cầu thủ trả bóng

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

everyMinutes(n)

Chỉ định chạy điều kiện kích hoạt 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ạiNội dung mô tả
nIntegerSố phút giữa các lần thực thi.

Cầu thủ trả bóng

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

everyWeeks(n)

Chỉ định chạy điều kiện kích hoạt n tuần một lần. 

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

Các tham số

TênLoạiNội dung mô tả
nIntegerSố tuần giữa các lần thực thi.

Cầu thủ trả bóng

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ờ của tập lệnh.

Danh sách chuỗi múi giờ hợp lệ tương ứng với chuỗi múi giờ hợp lệ được Joda.org liệt kê. Chuỗi múi giờ không hợp lệ khiến tập lệnh báo 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ạiNội dung mô tả
timezoneStringMúi giờ để xử lý thông tin thời gian trong sự kiện.

Cầu thủ trả bóng

ClockTriggerBuilder – ClockTriggerBuilder này, để tạo chuỗi.

nearMinute(minute)

Chỉ định số phút mà trình kích hoạt chạy (cộng hoặc trừ 15 phút). Nếu bạn không gọi nearMinute(), một 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ạiNội dung mô tả
minuteIntegerPhút kích hoạt.

Cầu thủ trả bóng

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ạiNội dung mô tả
dayIntegerNgày trong tháng sẽ lên lịch điều kiện kích hoạt.

Cầu thủ trả bóng

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ạiNội dung mô tả
dayWeekdayNgày trong tuần sẽ kích hoạt.

Cầu thủ trả bóng

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