get_the_modified_date() WP 2.1

Получает дату (время), когда в последний раз была изменена запись (пост).

Обычно эта функция используется внутри цикла.

Чтобы получить время изменения записи, используйте почти копию этой функции - get_the_modified_time( $d, $post ). Или укажите формат времени в параметре $d для этой функции.

Возвращает

Строку. Дату изменения.

Использование

get_the_modified_date( $d, $post );

$d(строка)

Формат в котором будет отображаться дата. Указывать в принятом в PHP формате: см. здесь.
По умолчанию: get_option('date_format')

$post(число/WP_Post)

ID или объект записи, дату изменения которой нужно получить. С Версии 4.6.
По умолчанию: null (текущая запись)

Примеры

#1. Выведем дату последнего изменения поста:

echo 'Пост был изменен: '. get_the_modified_date();

#2. Укажем произвольный формат даты последнего изменения:

echo 'Пост был изменен: .' get_the_modified_date('F j, Y');
// Пост был изменен: Август 31, 2013

echo 'Изменен: '. get_the_modified_date('F j, Y в G:i');
// Изменен: Январь 23, 2013 в 14:38

#3. Чтобы вставить html теги в формат, их нужно претворять знаком \:

echo 'Изменен: '. get_the_modified_date('j\<\s\u\p\>M\<\/\s\u\p\> Y');

// Изменен: Декабрь 25<sup>Арп</sup> 2011

Список изменений

Код get the modified date: wp-includes/general-template.php ^{WP 5.4}

<?php
function get_the_modified_date( $format = '', $post = null ) {
	$post = get_post( $post );

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

	/**
	 * Filters the date a post was last modified.
	 *
	 * @since 2.1.0
	 * @since 4.6.0 Added the `$post` parameter.
	 *
	 * @param string|bool  $the_time The formatted date or false if no post is found.
	 * @param string       $format   PHP date format. Defaults to value specified in
	 *                               'date_format' option.
	 * @param WP_Post|null $post     WP_Post object or null if no post is found.
	 */
	return apply_filters( 'get_the_modified_date', $the_time, $format, $post );
}

Cвязанные функции

Из метки: modified (author date time)

Еще из метки: date time (дата время)

Еще из раздела: Записи: посты, страницы, ...