Функция 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!