WC_Action_Queue::get_next()publicWC 1.0

Get the date and time for the next scheduled occurrence of an action with a given hook (an optionally that matches certain args and group), if any.

Method of the class: WC_Action_Queue{}

No Hooks.


WC_DateTime|null. The date and time for the next occurrence, or null if there is no pending, scheduled action for the given hook.


$WC_Action_Queue = new WC_Action_Queue();
$WC_Action_Queue->get_next( $hook, $args, $group );
$hook(string) (required)
The hook that the job will trigger.
Filter to a hook with matching args that will be passed to the job when it runs.
Default: null
Filter to only actions assigned to a specific group.
Default: ''

WC_Action_Queue::get_next() code WC 7.5.1

public function get_next( $hook, $args = null, $group = '' ) {

	$next_timestamp = as_next_scheduled_action( $hook, $args, $group );

	if ( is_numeric( $next_timestamp ) ) {
		return new WC_DateTime( "@{$next_timestamp}", new DateTimeZone( 'UTC' ) );

	return null;