Trình tạo cho trình kích hoạt đồng hồ.
Phương thức
| Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
|---|---|---|
after(durationMilliseconds) | Clock | 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à điều kiện kích hoạt sẽ chạy. |
at(date) | Clock | Chỉ định thời điểm trình kích hoạt chạy. |
at | Clock | Chỉ định rằng điều kiện kích hoạt sẽ hoạt động vào ngày đã cho, theo mặc định là gần nửa đêm (+/- 15 phút). |
at | Clock | Chỉ định giờ mà điều kiện kích hoạt sẽ chạy. |
create() | Trigger | Tạo điều kiện kích hoạt. |
every | Clock | Chỉ định chạy điều kiện kích hoạt sau mỗi n ngày. |
every | Clock | Chỉ định chạy điều kiện kích hoạt mỗi n giờ. |
every | Clock | Chỉ định chạy điều kiện kích hoạt mỗi n phút. |
every | Clock | Chỉ định chạy điều kiện kích hoạt mỗi n tuần. |
in | Clock | Chỉ định múi giờ cho ngày/giờ được chỉ định khi điều kiện kích hoạt chạy. |
near | Clock | Chỉ định phút mà điều kiện kích hoạt chạy (cộng hoặc trừ 15 phút). |
on | Clock | Chỉ định ngày trong tháng mà điều kiện kích hoạt chạy. |
on | Clock | 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à điều kiện kích hoạt sẽ 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 mà bạn chỉ định.
// Creates a trigger that runs 10 minutes later ScriptApp.newTrigger('myFunction').timeBased().after(10 * 60 * 1000).create();
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
duration | Integer | Thời lượng tối thiểu (tính bằng mili giây) sau thời gian hiện tại mà điều kiện kích hoạt sẽ chạy. |
Cầu thủ trả bóng
ClockTriggerBuilder – Trình tạo, để liên kết.
at(date)
Chỉ định thời điểm trình kích hoạt chạy.
// Creates a trigger for December 1, 2012 const triggerDay = new Date(2012, 11, 1); ScriptApp.newTrigger('myFunction').timeBased().at(triggerDay).create();
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
date | Date | Một đối tượng Ngày biểu thị thời điểm điều kiện kích hoạt sẽ chạy. |
Cầu thủ trả bóng
ClockTriggerBuilder – Trình tạo, để liên kết.
atDate(year, month, day)
Chỉ định rằng điều kiện kích hoạt sẽ hoạt động vào ngày đã cho, 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();
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
year | Integer | Năm dương lịch để lên lịch cho điều kiện kích hoạt. |
month | Integer | Tháng theo lịch để lên lịch cho điều kiện kích hoạt (phải là một số từ 1 đến 12, bao gồm cả 1 và 12). |
day | Integer | Ngày trên lịch để lên lịch cho điều kiện kích hoạt (phải là một số từ 1 đến 31, bao gồm cả 1 và 31). |
Cầu thủ trả bóng
ClockTriggerBuilder – Trình tạo, để liên kết.
atHour(hour)
Chỉ định giờ mà điều kiện kích hoạt sẽ 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();
Thông 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, để liên kết.
create()
everyDays(n)
Chỉ định chạy điều kiện kích hoạt sau mỗi n ngày.
ScriptApp.newTrigger('myFunction').timeBased().everyDays(3).create();
Thông 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, để liên kết.
everyHours(n)
Chỉ định chạy điều kiện kích hoạt mỗi n giờ.
ScriptApp.newTrigger('myFunction').timeBased().everyHours(12).create();
Thông 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, để liên kết.
everyMinutes(n)
Chỉ định chạy điều kiện kích hoạt mỗi n phút. n phải là 1, 5, 10, 15 hoặc 30.
ScriptApp.newTrigger('myFunction').timeBased().everyMinutes(10).create();
Thông 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, để liên kết.
everyWeeks(n)
Chỉ định chạy điều kiện kích hoạt mỗi n tuần.
ScriptApp.newTrigger('myFunction') .timeBased() .everyWeeks(2) .onWeekDay(ScriptApp.WeekDay.FRIDAY) .create();
Thông 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, để liên kết.
inTimezone(timezone)
Chỉ định múi giờ cho ngày/giờ được chỉ định khi điều kiện 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 các chuỗi múi giờ hợp lệ tương ứng với danh sách các 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ặp 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();
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
timezone | String | Múi giờ dùng để xử lý thông tin về thời gian trong sự kiện. |
Cầu thủ trả bóng
ClockTriggerBuilder – ClockTriggerBuilder này dùng để xâu 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(), hệ thống sẽ sử dụng một giá trị phút ngẫu nhiên.
// 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();
Thông 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, để liên kết.
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();
Thông số
| Tên | Loại | Mô tả |
|---|---|---|
day | Integer | Ngày trong tháng mà bạn muố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, để liên kết.
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();
Thông 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, để liên kết.