wp_next_scheduled() WP 1.0
Retrieve the next timestamp for an event.
Basis of: wp_schedule_single_event()
1 time = 0.001667s = very slow | 50000 times = 3.12s = fast | PHP 7.2.5, WP 4.9.8
No Hooks.
Return
Int/false. The Unix timestamp of the next time the event will occur. False if the event doesn't exist.
Usage
wp_next_scheduled( $hook, $args );
- $hook(string) (required)
- Action hook of the event.
- $args(array)
- Array containing each separate argument to pass to the hook's callback function. Although not passed to a callback, these arguments are used to uniquely identify the event, so they should be the same as those used when originally scheduling the event.
Default: array()
Changelog
Since 2.1.0 | Introduced. |
Code of wp_next_scheduled() wp next scheduled WP 5.6
function wp_next_scheduled( $hook, $args = array() ) {
$next_event = wp_get_scheduled_event( $hook, $args );
if ( ! $next_event ) {
return false;
}
return $next_event->timestamp;
}