Returning a non-null value will short-circuit the normal process, returning the filtered value instead. Return false if the event does not exist, otherwise an event object should be returned.
Parameters
$prenull|false|object
Value to return instead. Default null to continue retrieving the event.
$hookstring
Action hook of the event.
$argsarray
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.
$timestampint|null
Unix timestamp (UTC) of the event. Null to retrieve next scheduled event.
764<?php765 * @param string $hook Action hook of the event.766 * @param array $args Array containing each separate argument to pass to the hook's callback function.767 * Although not passed to a callback, these arguments are used to uniquely identify768 * the event.769 * @param int|null $timestamp Unix timestamp (UTC) of the event. Null to retrieve next scheduled event.770 */771 $pre = apply_filters( 'pre_get_scheduled_event', null, $hook, $args, $timestamp );772773 if ( null !== $pre ) {774 return $pre;775 }776777 if ( null !== $timestamp && ! is_numeric( $timestamp ) ) {
History
Introduced in 5.1.0. Unchanged from 6.7.7 through 7.1.0.