Функция GET_THE_DATE() в WordPress: основные отличия от the_date(), примеры использования

Функция GET_THE_DATE() в WordPress

Функция get_the_date() возвращает дату создания текущего поста. Вы можете указать формат отображения даты по своему усмотрению. Эта функция используется в цикле WordPress.

Основные отличия от функции the_date()

get_the_date() всегда возвращает дату, даже если следующий пост в цикле был опубликован в тот же день. В отличие от этого, the_date() пропускает вывод даты, если она совпадает с предыдущей.

Вы можете использовать фильтр get_the_date, чтобы изменить строку вывода даты.

Использование функции

get_the_date( $format, $post );

Параметры:

  • $format (string): Формат даты в стиле PHP. Опционально.

    • По умолчанию: 'date_format'
  • $post (int|WP_Post): ID поста или объект WP_Post.

    • По умолчанию: текущий пост

Примеры

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

Вывод: Дата публикации поста: 11-6-2018

Пример 2: Простой пример

Вывод даты поста в цикле WordPress:

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

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

  • String: Дата, когда был написан текущий пост.
  • Int или false: Возвращает false в случае ошибки.

Внутренний код функции

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

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

if ( ! $post ) {
    return false;
}

$_format = ! empty( $format ) ? $format : get_option( 'date_format' );

$the_date = get_post_time( $_format, false, $post, true );

/**
 * Filters the date a post was published.
 *
 * @since 3.0.0
 *
 * @param string|int  $the_date Форматированная строка даты или Unix timestamp, если $format 'U' или 'G'.
 * @param string      $format   Формат даты PHP.
 * @param WP_Post     $post     Объект поста.
 */
return apply_filters( 'get_the_date', $the_date, $format, $post );

}

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

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

  • comment_date()
  • comment_time()
  • current_time()
  • date_i18n()
  • get_comment_date()
  • get_post_time()
  • get_the_modified_date()
  • get_the_time()

Эти функции могут помочь вам управлять датами и временем в ваших постах и комментариях.

Теперь вы знаете, как использовать функцию get_the_date() для вывода даты поста в WordPress!

Leave a Reply

Ваш адрес email не будет опубликован. Обязательные поля помечены *