wp_get_scheduled_event()

wp_get_scheduled_event() — Retrieves a scheduled event. Retrieves the full event object for a given event, if no timestamp is specified the next scheduled event is returned.

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 should be the same as those used when originally scheduling the event. Default empty array. $timestamp (int|null): Optional. Unix timestamp (UTC) of the event. If not specified, the next scheduled event is returned. Default null.

Returns stdClass|false: The event object. False if the event does not exist. Field $hook (string): Action hook to execute when the event is run. Field $timestamp (int): Unix timestamp (UTC) for when to next run the event. Field $schedule (string|false): How often the event should subsequently recur. Field $args (array): Array containing each separate argument to pass to the hook’s callback function. Field $interval (int): Optional. The interval time in seconds for the schedule. Only present for recurring events.