W3cubDocs

/WordPress

wp_next_scheduled( string $hook, array $args = array() )

Retrieve the next timestamp for an event.

Parameters

$hook

(string) (Required) Action hook of the event.

$args

(array) (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 value: array()

Return

(int|false) The Unix timestamp of the next time the event will occur. False if the event doesn't exist.

Source

File: wp-includes/cron.php 

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

	return $next_event->timestamp;
}

Used By

Used By Description
wp-admin/includes/update.php: wp_get_auto_update_message()

Determines the appropriate auto-update message to be displayed.
wp-admin/includes/class-wp-site-health.php: WP_Site_Health::maybe_create_scheduled_event()

Create a weekly cron event, if one does not already exist.
wp-includes/class-wp-recovery-mode.php: WP_Recovery_Mode::initialize()

Initialize recovery mode for the current request.
wp-includes/functions.php: wp_schedule_delete_old_privacy_export_files()

Schedule a WP_Cron job to delete expired export files.
wp-admin/includes/post.php: get_default_post_to_edit()

Default post information to use when populating the “Write Post” form.
wp-includes/update.php: wp_schedule_update_checks()

Schedule core, theme, and plugin update checks.
wp-includes/update.php: wp_version_check()

Check WordPress version against the newest version.
wp-includes/post.php: _publish_post_hook()

Hook to schedule pings and enclosures when a post is published.
wp-includes/ms-functions.php: wp_schedule_update_network_counts()

Schedule update of the network-wide counts for the current network.

Changelog

Version Description
2.1.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_next_scheduled