wpseek.com
A WordPress-centric search engine for devs and theme authors



wp_next_scheduled › WordPress Function

Since2.1.0
Deprecatedn/a
› wp_next_scheduled ( $hook, $args = array() )
Parameters: (2)
  • (string) $hook Action hook of the event.
    Required: Yes
  • (array) $args Optional. 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 empty array.
    Required: No
    Default: array()
Returns:
  • (int|false) The Unix timestamp of the next time the event will occur. False if the event doesn't exist.
Defined at:
Codex:

Retrieves the next timestamp for an event.



Related Functions: wp_get_schedule, wp_get_schedules, wp_get_scheduled_event, wp_clear_scheduled_hook, wp_unschedule_hook

Source 

function wp_next_scheduled( $hook, $args = array() ) {
	$next_event = wp_get_scheduled_event( $hook, $args );

	if ( ! $next_event ) {
		return false;
	}

	return $next_event->timestamp;
}