Функция GET_LASTPOSTDATE() │ WP 0.71

Функция get_lastpostdate() предназначена для получения даты последнего опубликованного поста на вашем сайте.

Что такое get_lastpostdate()?

Эта функция возвращает дату, когда был опубликован последний пост. Важно знать, что:

• Часовой пояс — используется стандартный часовой пояс сервера. Он показывает разницу между всемирным временем (GMT) и временем, установленным на сервере.
• Значения:
  • 'blog' — это дата последнего поста в формате, установленном для вашего блога.
  • 'gmt' — это дата последнего поста в формате GMT.

Сложность и производительность

Вызов функции get_lastpostdate() происходит за разное время в зависимости от её использования:

• 1 раз — 0.001661 сек (очень медленно)
• 50000 раз — 0.20 сек (очень быстро)

Проверено на PHP версии 7.0.5 и WordPress версии 4.4.2.

Хуки функции

Эта функция использует хук get_lastpostdate, позволяющий изменять возвращаемое значение.

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

Функция возвращает строку с датой последнего поста или false, если произошла ошибка.

Как использовать get_lastpostdate()

Пример использования функции:

get_lastpostdate( $timezone, $post_type );

Параметры

• $timezone (string): Указывает часовой пояс для времени:

  • 'server' — используется внутренний часовой пояс сервера.
  • 'blog' — использует дату поста в соответствии с установленным временем для сайта.
  • 'gmt' — использует дату поста в формате GMT.

  По умолчанию: 'server'

• $post_type (string): Указывает тип поста, который нужно проверить.
  По умолчанию: 'any' (любой тип поста).

Примеры

Вот несколько примеров использования функции:

echo get_lastpostdate( $timezone = 'server', $post_type = 'any' ); 
// Вывод: 2016-04-05 17:56:29.000000

echo get_lastpostdate( $timezone = 'blog', $post_type = 'post' ); 
// Вывод: 2016-03-05 01:46:44

echo get_lastpostdate( $timezone = 'gmt', $post_type = 'post' ); 
// Вывод: 2016-03-04 20:46:44

Вы можете добавить свои примеры, если хотите.

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

• С версии 0.71 — Функция была введена.
• С версии 4.4.0 — Добавлен параметр $post_type.

Исходный код функции

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

function get_lastpostdate( $timezone = 'server', $post_type = 'any' ) {
$lastpostdate = _get_last_post_time( $timezone, 'date', $post_type );

/**  
 * Фильтрует время последнего опубликованного поста на сайте.  
 *  
 * @since 2.3.0  
 * @since 5.5.0 Добавлен параметр $post_type.  
 *  
 * @param string|false $lastpostdate Время последнего опубликованного поста,  
 *                                    в формате 'Y-m-d H:i:s'. False при ошибке.  
 * @param string       $timezone     Местоположение для получения даты публикации поста.  
 *                                    См. get_lastpostdate() для допустимых значений $timezone.  
 * @param string       $post_type    Тип поста для проверки.  
 */  
return apply_filters( 'get_lastpostdate', $lastpostdate, $timezone, $post_type );  

}

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

Работа с датами и временем в WordPress

Вот некоторые функции, которые могут быть полезны для работы с датами:

• comment_date()
• comment_time()
• current_time()
• date_i18n()
• get_comment_date()
• get_comment_time()
• get_lastpostmodified()
• get_post_time()
• get_the_date()
• и многие другие.

Эти функции позволяют вам более гибко работать с датами и временем на сайте WordPress.