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

Retrieve the time at which the post was last modified.

Description Description

Parameters Parameters


(string) (Optional) Format to use for retrieving the time the post was modified. Either 'G', 'U', or php date format.

Default value: 'U'


(bool) (Optional) Whether to retrieve the GMT time.

Default value: false


(int|WP_Post) (Optional) WP_Post object or ID. Default is global $post object.

Default value: null


(bool) (Optional) Whether to translate the time string.

Default value: false

Top ↑

Return Return

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

Top ↑

Source Source

File: wp-includes/general-template.php

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

	if ( ! $post ) {
		return false;

	if ( $gmt ) {
		$time = $post->post_modified_gmt;
	} else {
		$time = $post->post_modified;
	$time = mysql2date( $d, $time, $translate );

	 * Filters the localized time a post was last modified.
	 * @since 2.8.0
	 * @param string $time The formatted time.
	 * @param string $d    The date format. Accepts 'G', 'U', or php date format. Default 'U'.
	 * @param bool   $gmt  Whether to return the GMT time. Default false.
	return apply_filters( 'get_post_modified_time', $time, $d, $gmt );

Top ↑

Changelog Changelog

Version Description
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.