Функция the_modified_date(): показ даты изменения поста

# Функция the_modified_date() │ WP 2.1.0

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

**Используется:** get_the_modified_date()

**Производительность:** 1 раз — 0.000555 сек (медленно) | 50000 раз — 1.86 сек (быстро) | PHP 7.1.2, WP 4.7.3

## Хуки функции

- the_modified_date

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

Тип: String|null. Вернет строку с датой, если она найдена.

## Как использовать

Используйте the_modified_date( $format, $before, $after, $display );

- **$format (string):** Формат даты в формате PHP. По умолчанию: 'date_format' 
- **$before (string):** Текст, который выводится перед датой. По умолчанию: '' 
- **$after (string):** Текст, который выводится после даты. По умолчанию: '' 
- **$display (true|false):** Показывать дату или вернуть ее. По умолчанию: true 

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

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

```php
Последнее изменение: 

Выведет: Последнее изменение: 2 декабря 2006

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

Последнее изменение: 

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

Пример 3: Вывод даты и времени изменения поста.

Последнее изменение: 

Выведет: Последнее изменение: 2 декабря 2006 в 13:36.

Или можно использовать так:

Пример 4: Использование HTML-тегов в формате.

Чтобы вставить HTML-теги в формат, используйте символы экранирования ``:

Изменено: M Y'); ?>

Выведет: Изменено: 25 декабря 2011

Изменения в функции

С версии: 2.1.0 - Введена.

Код функции

function the_modified_date( $format = '', $before = '', $after = '', $display = true ) {
    $the_modified_date = $before . get_the_modified_date( $format ) . $after;

    /**
     * Фильтрует дату последнего изменения поста для отображения.
     *
     * @since 2.1.0
     *
     * @param string|false $the_modified_date Дата последнего изменения или false, если пост не найден.
     * @param string       $format            Формат даты в PHP.
     * @param string       $before            HTML-текст перед датой.
     * @param string       $after             HTML-текст после даты.
     */
    $the_modified_date = apply_filters( 'the_modified_date', $the_modified_date, $format, $before, $after );

    if ( $display ) {
        echo $the_modified_date;
    } else {
        return $the_modified_date;
    }
}

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

• get_the_modified_date()
• get_the_modified_time()
• the_modified_author()
• edit_post_link()
• get_delete_post_link()
• get_edit_post_link()
• get_permalink()
• get_the_content()
• the_excerpt()
• the_ID()
• ...и другие полезные функции для работы с постами и страницами.