wp_get_schedule() │ WP 2.1.0

Retrieves the name of the recurrence schedule for an event.

Return

String|false. Schedule name on success, false if no schedule.

Usage

wp_get_schedule( $hook, $args );

$hook(string) (required)

Action hook to identify the event.

$args(array)

Arguments passed to the event's callback function.
Default: empty array

Notes

• See: wp_get_schedules() for available schedules.

Changelog

wp_get_schedule() wp get schedule code ^{WP 6.7.1}

function wp_get_schedule( $hook, $args = array() ) {
	$schedule = false;
	$event    = wp_get_scheduled_event( $hook, $args );

	if ( $event ) {
		$schedule = $event->schedule;
	}

	/**
	 * Filters the schedule name for a hook.
	 *
	 * @since 5.1.0
	 *
	 * @param string|false $schedule Schedule for the hook. False if not found.
	 * @param string       $hook     Action hook to execute when cron is run.
	 * @param array        $args     Arguments to pass to the hook's callback function.
	 */
	return apply_filters( 'get_schedule', $schedule, $hook, $args );
}