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()
  • (false|int) 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() ) {
	$crons = _get_cron_array();
	$key   = md5( serialize( $args ) );
	if ( empty( $crons ) ) {
		return false;
	foreach ( $crons as $timestamp => $cron ) {
		if ( isset( $cron[ $hook ][ $key ] ) ) {
			return $timestamp;
	return false;