wp_next_scheduled()

wp_next_scheduled() — Retrieves the timestamp of the next scheduled event for the given hook.

Inputs: $hook (string): 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 must match those used when originally scheduling the event. If the arguments do not match exactly, the event will not be found. Default empty array.

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