get_post_modified_time() – Function | Developer.WordPress.org

Retrieves the time at which the post was last modified.

Parameters

$formatstringoptional: Format to use for retrieving the time the post was modified. Accepts 'G', 'U', or PHP date format. Default 'U'.
Default:'U'
$gmtbooloptional: Whether to retrieve the GMT time.
Default:false
$postint|WP_Postoptional: Post ID or post object. Default is global $post object.
Default:null
$translatebooloptional: Whether to translate the time string.
Default:false

Return

string|int|false Formatted date string or Unix timestamp if $format is 'U' or 'G'.
False on failure.

More Information

One level »lower« than get_the_modified_time() , but can take more arguments.

Source

function get_post_modified_time( $format = 'U', $gmt = false, $post = null, $translate = false ) {
	$post = get_post( $post );

	if ( ! $post ) {
		return false;
	}

	$source   = ( $gmt ) ? 'gmt' : 'local';
	$datetime = get_post_datetime( $post, 'modified', $source );

	if ( false === $datetime ) {
		return false;
	}

	if ( 'U' === $format || 'G' === $format ) {
		$time = $datetime->getTimestamp();

		// Returns a sum of timestamp with timezone offset. Ideally should never be used.
		if ( ! $gmt ) {
			$time += $datetime->getOffset();
		}
	} elseif ( $translate ) {
		$time = wp_date( $format, $datetime->getTimestamp(), $gmt ? new DateTimeZone( 'UTC' ) : null );
	} else {
		if ( $gmt ) {
			$datetime = $datetime->setTimezone( new DateTimeZone( 'UTC' ) );
		}

		$time = $datetime->format( $format );
	}

	/**
	 * Filters the localized time a post was last modified.
	 *
	 * @since 2.8.0
	 *
	 * @param string|int $time   Formatted date string or Unix timestamp if `$format` is 'U' or 'G'.
	 * @param string     $format Format to use for retrieving the time the post was modified.
	 *                           Accepts 'G', 'U', or PHP date format. Default 'U'.
	 * @param bool       $gmt    Whether to retrieve the GMT time. Default false.
	 */
	return apply_filters( 'get_post_modified_time', $time, $format, $gmt );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘get_post_modified_time’, string|int $time, string $format, bool $gmt ): Filters the localized time a post was last modified.

Uses	Description
wp_date()`wp-includes/functions.php`	Retrieves the date, in localized format.
get_post_datetime()`wp-includes/general-template.php`	Retrieves post published or modified time as a `DateTimeImmutable` object instance.
apply_filters()`wp-includes/plugin.php`	Calls the callback functions that have been added to a filter hook.
get_post()`wp-includes/post.php`	Retrieves post data given a post ID or post object.

Show 2 more Show less

Used by	Description
get_the_modified_date()`wp-includes/general-template.php`	Retrieves the date on which the post was last modified.
get_the_modified_time()`wp-includes/general-template.php`	Retrieves the time at which the post was last modified.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Skip to note 6 content

souzadavi 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

If you would like to get the date on your own language defined in WP, just set the parameter translate as true, example:

get_post_modified_time( ‘j \d\e F \d\e Y’, false, null, true);

For me on portuguese, it will return: 14 de novembro de 2019

Log in to add feedback
Skip to note 7 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
This example was migrated from Codex:

Get a timestamp for the current post:
```
echo get_post_modified_time(); // 1490121048
```
Log in to add feedback
Skip to note 8 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
This example was migrated from Codex:

Get full date and time in current timezone:
```
echo get_post_modified_time('F d, Y g:i a'); // "March 21, 2017 12:02 pm"
```
Log in to add feedback
Skip to note 9 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
This example was migrated from Codex:

Get full date and time in UTC:
```
echo get_post_modified_time('F d, Y g:i a', true); // "March 21, 2017 7:02 pm"
```
Log in to add feedback
Skip to note 10 content

Steven Lin 5 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
This example was migrated from Codex:

Get full date and time in UTC with localization (as per WordPress settings):
```
echo get_post_modified_time('F d, Y g:i a', true, null, true); // "März 21, 2017 7:02 pm"
```
Log in to add feedback

get_post_modified_time( string $format = 'U', bool $gmt = false, int|WP_Post $post = null, bool $translate = false ): string|int|false

In this article