get_the_modified_time( string $d = '', int|WP_Post $post = null )

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 defaults to the value specified in the time_format option.

Default value: ''


(int|WP_Post) (Optional) Post ID or WP_Post object. Default current post.

Default value: null

Top ↑

Return Return

(false|string) Formatted date string or Unix timestamp. False on failure.

Top ↑

Source Source

File: wp-includes/general-template.php

function get_the_modified_time( $d = '', $post = null ) {
	$post = get_post( $post );

	if ( ! $post ) {
		// For backward compatibility, failures go through the filter below.
		$the_time = false;
	} elseif ( empty( $d ) ) {
		$the_time = get_post_modified_time( get_option( 'time_format' ), false, $post, true );
	} else {
		$the_time = get_post_modified_time( $d, false, $post, true );

	 * Filters the localized time a post was last modified.
	 * @since 2.0.0
	 * @since 4.6.0 Added the `$post` parameter.
	 * @param string|bool  $the_time The formatted time or false if no post is found.
	 * @param string       $d        Format to use for retrieving the time the post was
	 *                               written. Accepts 'G', 'U', or php date format. Defaults
	 *                               to value specified in 'time_format' option.
	 * @param WP_Post|null $post     WP_Post object or null if no post is found.
	return apply_filters( 'get_the_modified_time', $the_time, $d, $post );

Top ↑

Changelog Changelog

Version Description
4.6.0 Added the $post parameter.
2.0.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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