参数
- $hook
-
(string)(必填) 事件的动作钩子。
- $args
-
(array)(可选) 数组，该数组包含要传递给钩子回调函数的每个单独参数。虽然没有传递给回调，但这些参数用于唯一标识事件，因此它们应该与最初调度事件时使用的参数相同。
默认值: array()
返回
(int|false) 计划任务事件下次发生的Unix时间戳。如果事件不存在，则为false。
源码
更新日志
| 版本 | 描述 |
|---|---|
| 2.1.0 | 开始引入 |
使用示例
请注意$args参数！不在wp_next_scheduled中指定$args参数，但为wp_schedule_event设置$args将导致调度许多事件（而不是仅调度一个）。
错误例子：
if ( ! wp_next_scheduled( 'myevent' ) ) { // This will always be false wp_schedule_event( time(), 'daily', 'myevent', array( false ) ); }这是一个很好的例子：
$args = array( false ); if ( ! wp_next_scheduled( 'myevent', $args ) ) { wp_schedule_event( time(), 'daily', 'myevent', $args ); }使用参数时要小心！WordPress没有将它们进行1:1的比较，所以你必须注意它们是什么类型。
这是因为WP生成了它们的散列：
md5( serialize( $args ) )所以当你有：
wp_schedule_event( time(), 'daily', 'action_hook', array( 123 ) );
使用字符串，因为值取自meta：
wp_next_scheduled( 'action_hook', array( '123' ) );
它将返回false。