WPS 基础接口 > 表格 API 参考 > Application > 方法 > Application.OnTime 方法
安排一个过程在将来的特定时间运行(既可以是具体指定的某个时间,也可以是指定的一段时间之后)。

语法

表达式.OnTime(EarliestTime, Procedure, LatestTime, Schedule)

表达式   一个代表 Application 对象的变量。

参数

名称 必选/可选 数据类型 说明
EarliestTime 必选 Variant 希望此过程运行的时间。
Procedure 必选 String 要运行的过程名。
LatestTime 可选 Variant 过程开始运行的最晚时间。例如,如果 LatestTime 参数设置为 EarliestTime + 30,且当到达 EarliestTime 时间时,由于其他过程处于运行状态而导致 ET 不能处于“就绪”、“复制”、“剪切”或“查找”模式,则 ET 将等待 30 秒让第一个过程先完成。如果 ET 不能在 30 秒内回到“就绪”模式,则不运行此过程。如果省略该参数,ET 将一直等待到可以运行该过程为止。
Schedule 可选 Variant 如果为 True,则预定一个新的 OnTime 过程。如果为 False,则清除先前设置的过程。默认值为 True

说明

使用 Now + TimeValue(time) 可安排经过一段时间(从现在开始计时)之后运行某个过程。使用 TimeValue(time) 可安排某个过程只运行指定的时间。

示例

本示例设置从现在开始 15 秒后运行 my_Procedure。

示例代码
let now = new Date()
let seconds = now.getTime()
now.setTime(seconds + 1000 * 15)
Application.OnTime(now.toLocaleString(), "my_Procedure")

本示例设置 my_Procedure 在下午 5 点开始运行。

示例代码
Application.OnTime("17:00:00", "my_Procedure")

本示例撤消前一个示例对 OnTime 的设置。

示例代码
Application.OnTime("17:00:00", "my_Procedure", undefined , false)

On Time Method


请参阅