W3cubDocs

/WordPress

get_feed_build_date( string $format )

Get the UTC time of the most recently modified post from WP_Query.

Description

If viewing a comment feed, the time of the most recently modified comment will be returned.

Parameters

$format

(string) (Required) Date format string to return the time in.

Return

(string|false) The time in requested format, or false on failure.

Source

File: wp-includes/feed.php 

function get_feed_build_date( $format ) {
	global $wp_query;

	$datetime          = false;
	$max_modified_time = false;
	$utc               = new DateTimeZone( 'UTC' );

	if ( ! empty( $wp_query ) && $wp_query->have_posts() ) {
		// Extract the post modified times from the posts.
		$modified_times = wp_list_pluck( $wp_query->posts, 'post_modified_gmt' );

		// If this is a comment feed, check those objects too.
		if ( $wp_query->is_comment_feed() && $wp_query->comment_count ) {
			// Extract the comment modified times from the comments.
			$comment_times = wp_list_pluck( $wp_query->comments, 'comment_date_gmt' );

			// Add the comment times to the post times for comparison.
			$modified_times = array_merge( $modified_times, $comment_times );
		}

		// Determine the maximum modified time.
		$datetime = date_create_immutable_from_format( 'Y-m-d H:i:s', max( $modified_times ), $utc );
	}

	if ( false === $datetime ) {
		// Fall back to last time any post was modified or published.
		$datetime = date_create_immutable_from_format( 'Y-m-d H:i:s', get_lastpostmodified( 'GMT' ), $utc );
	}

	if ( false !== $datetime ) {
		$max_modified_time = $datetime->format( $format );
	}

	/**
	 * Filters the date the last post or comment in the query was modified.
	 *
	 * @since 5.2.0
	 *
	 * @param string|false $max_modified_time Date the last post or comment was modified in the query, in UTC.
	 *                                        False on failure.
	 * @param string       $format            The date format requested in get_feed_build_date().
	 */
	return apply_filters( 'get_feed_build_date', $max_modified_time, $format );
}

Uses

Uses Description
wp-includes/feed.php: get_feed_build_date

Filters the date the last post or comment in the query was modified.
wp-includes/class-wp-query.php: WP_Query::is_comment_feed()

Is the query for a comments feed?
wp-includes/class-wp-query.php: WP_Query::have_posts()

Determines whether there are more posts available in the loop.
wp-includes/functions.php: wp_list_pluck()

Pluck a certain field out of each object in a list.
wp-includes/plugin.php: apply_filters()

Calls the callback functions that have been added to a filter hook.
wp-includes/post.php: get_lastpostmodified()

Get the most recent time that a post on the site was modified.

Changelog

Version Description
5.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/get_feed_build_date