wp_get_schedule( string $hook, array $args = array() )
Retrieve the recurrence schedule for an event.
Description
See also
- wp_get_schedules(): for available schedules.
Parameters
- $hook
-
(string) (Required) Action hook to identify the event.
- $args
-
(array) (Optional) Arguments passed to the event's callback function.
Default value: array()
Return
(string|false) Schedule name on success, false if no schedule.
Source
File: wp-includes/cron.php
function wp_get_schedule( $hook, $args = array() ) { $schedule = false; $event = wp_get_scheduled_event( $hook, $args ); if ( $event ) { $schedule = $event->schedule; } /** * Filters the schedule 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 ); }
Changelog
Version | Description |
---|---|
5.1.0 | 'get_schedule' filter added. |
2.1.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_get_schedule