Trình tạo trình kích hoạt đồng hồ.
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
after(durationMilliseconds) | ClockTriggerBuilder | 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. |
at(date) | ClockTriggerBuilder | Chỉ định thời điểm chạy điều kiện kích hoạt. |
atDate(year, month, day) | ClockTriggerBuilder | Chỉ định trình kích hoạt sẽ kích hoạt vào ngày nhất định, theo mặc định là gần nửa đêm (+/- 15 phút). |
atHour(hour) | ClockTriggerBuilder | Chỉ định giờ chạy điều kiện kích hoạt. |
create() | Trigger | Tạo trình kích hoạt. |
everyDays(n) | ClockTriggerBuilder | Chỉ định chạy điều kiện kích hoạt n ngày một lần. |
everyHours(n) | ClockTriggerBuilder | Chỉ định chạy điều kiện kích hoạt n giờ một lần. |
everyMinutes(n) | ClockTriggerBuilder | Chỉ định chạy trình kích hoạt n phút một lần. |
everyWeeks(n) | ClockTriggerBuilder | Chỉ định chạy điều kiện kích hoạt n tuần một lần. |
inTimezone(timezone) | ClockTriggerBuilder | Chỉ định múi giờ cho các ngày/giờ được chỉ định khi điều kiện kích hoạt chạy. |
nearMinute(minute) | ClockTriggerBuilder | Chỉ định phút mà điều kiện kích hoạt chạy (cộng hoặc trừ 15 phút). |
onMonthDay(day) | ClockTriggerBuilder | Chỉ định ngày trong tháng mà điều kiện kích hoạt chạy. |
onWeekDay(day) | ClockTriggerBuilder | Chỉ định ngày trong tuần mà điều kiện 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 gian 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
durationMilliseconds | Integer | Thời lượng tối thiểu (tính bằng mili giây) sau thời gian hiện tại khi thì trình 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 chạy điều kiện kích hoạt.
// Creates a trigger for December 1, 2012 var triggerDay = new Date(2012, 11, 1); ScriptApp.newTrigger("myFunction") .timeBased() .at(triggerDay) .create();
Tham số
Tên | Loại | Mô tả |
---|---|---|
date | Date | Đối tượng Ngày biểu thị thời điểm chạy điều kiện 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 trình kích hoạt sẽ kích hoạt vào 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
year | Integer | Năm dương lịch để lên lịch kích hoạt. |
month | Integer | Tháng theo lịch để lên lịch trình kích hoạt (phải là một số từ 1 đến 12, dành cho tất cả mọi người). |
day | Integer | Ngày theo lịch để lên lịch trình kích hoạt (phải là một số từ 1 đến 31, dành cho tất cả mọi người). |
Cầu thủ trả bóng
ClockTriggerBuilder
– Trình tạo để tạo chuỗi.
atHour(hour)
Chỉ định giờ chạy điều kiện kích hoạt.
// 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
hour | Integer | Giờ kích hoạt. |
Cầu thủ trả bóng
ClockTriggerBuilder
– Trình tạo để tạo chuỗi.
create()
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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
n | Integer | Số 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
n | Integer | Số 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 trình 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
n | Integer | Số 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
n | Integer | Số 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 các ngày/giờ được chỉ định khi điều kiện kích hoạt chạy. Theo mặc định, 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 chuỗi múi giờ hợp lệ do Joda.org liệt kê. Chuỗi múi giờ không hợp lệ khiến tập lệnh gửi 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
timezone | String | Mú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 phút mà điều kiện kích hoạt chạy (cộng hoặc trừ 15 phút). Nếu bạn không gọi nearMinute()
, 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();
Tham số
Tên | Loại | Mô tả |
---|---|---|
minute | Integer | Phú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à điều kiện kích hoạt chạy.
// Schedules for the first of every month ScriptApp.newTrigger("myFunction") .timeBased() .onMonthDay(1) .create();
Tham số
Tên | Loại | Mô tả |
---|---|---|
day | Integer | Ngày trong tháng cần lên lịch cho đ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à điều kiện kích hoạt chạy.
ScriptApp.newTrigger("myFunction") .timeBased() .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Tham số
Tên | Loại | Mô tả |
---|---|---|
day | Weekday | Ngày trong tuần để kích hoạt. |
Cầu thủ trả bóng
ClockTriggerBuilder
– Trình tạo để tạo chuỗi.