A WordPress-centric search engine for devs and theme authors

wp_next_scheduled ›

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.
    Required: No
    Default: array()
  • (int|false) The Unix timestamp of the next time the event will occur. False if the event doesn't exist.
Defined at:

Retrieve the next timestamp for an event.


function wp_next_scheduled( $hook, $args = array() ) {
	$next_event = wp_get_scheduled_event( $hook, $args );
	if ( ! $next_event ) {
		return false;

	return $next_event->timestamp;