Получение даты последнего изменения поста в WordPress

Функция get_the_modified_date() позволяет узнать дату, когда пост был в последний раз изменён. Это полезно, если вы хотите показать читателям, как актуальна информация в вашем блоге или на сайте.

Как работает функция

Функция get_the_modified_date() использует другую функцию под названием get_post_modified_time(), чтобы получить дату изменения поста.

Возвращаемое значение

Функция возвращает:

• Строку (например, дата в формате "31 августа 2023")
• Целое число (если вы используете определённый формат)
• false (если произошла ошибка и пост не найден)

Синтаксис использования функции

get_the_modified_date( $format, $post );

Параметры

• $format (строка): формат даты в стиле PHP. Если не указано, используется формат по умолчанию ('date_format').
• $post (int|WP_Post): ID поста или объект WP_Post. Если не указано, используется текущий пост.

Примеры использования

Пример 1: Вывод даты последнего изменения поста

Этот код выведет дату последнего изменения поста.

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

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

Вы можете указать собственный формат даты. Например, так:

echo 'Пост был изменён: '. get_the_modified_date('F j, Y');
// Пример вывода: "Пост был изменён: August 31, 2013"

echo 'Изменено: '. get_the_modified_date('F j, Y в G:i');
// Пример вывода: "Изменено: January 23, 2013 в 14:38"

Пример 3: Вставка HTML-тегов в формат даты

Если вы хотите включить HTML-теги в формат даты, вам нужно экранировать их с помощью символа ``.

echo 'Изменено: '. get_the_modified_date('jM Y');
// Пример вывода: "Изменено: 25дек. 2011"

История изменений

• С версии 2.1.0: Функция была введена в WordPress.
• С версии 4.6.0: Добавлен параметр $post.

Код функции

Вот как выглядит код функции get_the_modified_date() в WordPress:

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

if ( ! $post ) {
    // На случай, если пост не найден, возвращаем false.
    $the_time = false;
} else {
    $_format = ! empty( $format ) ? $format : get_option( 'date_format' );

    $the_time = get_post_modified_time( $_format, false, $post, true );
}

/**
 * Фильтрует дату последнего изменения поста.
 *
 * @param string|int|false $the_time Отформатированная дата или false, если пост не найден.
 * @param string           $format   Формат даты в PHP.
 * @param WP_Post|null     $post     Объект WP_Post или null, если пост не найден.
 */
return apply_filters( 'get_the_modified_date', $the_time, $format, $post );

}

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

• Получение времени последнего изменения поста: get_the_modified_time()
• Показ даты изменения: the_modified_date()
• Показ автора изменений: the_modified_author()

Используйте эту функцию для повышения интерактивности и актуальности вашего контента на сайте!