W3cubDocs

/WordPress

wp_post_revision_title( int|object $revision, bool $link = true )

Retrieve formatted date timestamp of a revision (linked to that revisions’s page).

Parameters

$revision

(int|object) (Required) Revision ID or revision object.

$link

(bool) (Optional) Whether to link to revision's page.

Default value: true

Return

(string|false) i18n formatted datetimestamp or localized 'Current Revision'.

Source

File: wp-includes/post-template.php 

function wp_post_revision_title( $revision, $link = true ) {
	$revision = get_post( $revision );
	if ( ! $revision ) {
		return $revision;
	}

	if ( ! in_array( $revision->post_type, array( 'post', 'page', 'revision' ), true ) ) {
		return false;
	}

	/* translators: Revision date format, see https://www.php.net/date */
	$datef = _x( 'F j, Y @ H:i:s', 'revision date format' );
	/* translators: %s: Revision date. */
	$autosavef = __( '%s [Autosave]' );
	/* translators: %s: Revision date. */
	$currentf = __( '%s [Current Revision]' );

	$date      = date_i18n( $datef, strtotime( $revision->post_modified ) );
	$edit_link = get_edit_post_link( $revision->ID );
	if ( $link && current_user_can( 'edit_post', $revision->ID ) && $edit_link ) {
		$date = "<a href='$edit_link'>$date</a>";
	}

	if ( ! wp_is_post_revision( $revision ) ) {
		$date = sprintf( $currentf, $date );
	} elseif ( wp_is_post_autosave( $revision ) ) {
		$date = sprintf( $autosavef, $date );
	}

	return $date;
}

Uses

Uses Description
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/l10n.php: _x()

Retrieve translated string with gettext context.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/functions.php: date_i18n()

Retrieves the date in localized format, based on a sum of Unix timestamp and timezone offset in seconds.
wp-includes/link-template.php: get_edit_post_link()

Retrieves the edit post link for post.
wp-includes/post.php: get_post()

Retrieves post data given a post ID or post object.
wp-includes/revision.php: wp_is_post_autosave()

Determines if the specified post is an autosave.
wp-includes/revision.php: wp_is_post_revision()

Determines if the specified post is a revision.

Changelog

Version Description
2.6.0 Introduced.

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