wp_next_scheduled

💡 云策文档标注

概述

wp_next_scheduled 是一个 WordPress 过滤器钩子，用于修改指定钩子的下一个计划事件的时间戳。它允许开发者在事件执行前调整其计划时间。

apply_filters( 'wp_next_scheduled', $next_event->timestamp, $next_event, $hook, $args );

此过滤器仅影响通过 wp_schedule_event() 或类似函数安排的事件；确保正确处理时间戳以避免计划冲突。

📄 原文内容

Filters the timestamp of the next scheduled event for the given hook.

$timestampint

Unix timestamp (UTC) for when to next run the event.

$next_eventobject

An object containing an event’s data.

hook string
Action hook of the event.
timestamp int
Unix timestamp (UTC) for when to next run the event.
schedule string
How often the event should subsequently recur.
args array
Array containing each separate argument to pass to the hook callback function.
interval int
Optional. The interval time in seconds for the schedule. Only present for recurring events.

$argsarray

Array containing each separate argument to pass to the hook callback function.

return apply_filters( 'wp_next_scheduled', $next_event->timestamp, $next_event, $hook, $args );

Used by	Description
wp_next_scheduled()`wp-includes/cron.php`	Retrieves the timestamp of the next scheduled event for the given hook.

Version	Description
6.8.0	Introduced.