Функция get_the_time()
возвращает время создания или публикации поста в виде строки, отформатированной согласно заданному шаблону. Она используется в основном внутри Цикла WordPress, но также может применяться и вне его, если указать ID нужного поста.
get_the_time( string $format = '', int $post_id = 0 )
- $format (строка) – Необязательный параметр. Формат времени публикации поста, в котором оно будет возвращено. Для указания формата используются строки, такие как ‘F j, Y ga’. Если этот параметр не задан, будет использован формат времени, указанный в настройках WordPress.
- $post_id (целое число) – Необязательный параметр. ID поста, время публикации которого нужно получить. Если параметр не указан, используется ID текущего поста.
Возвращаемое значение
Функция возвращает строку с временем публикации поста в заданном формате. В случае ошибки или если формат не указан, возвращается пустая строка. Также возможны возвращаемые значения типа int
или false
, в зависимости от параметров.
Пример 1: Базовое использование
Вывод времени публикации текущего поста в формате, установленном в настройках WordPress:
<?php echo get_the_time(); ?>
Пример 2: Указание конкретного поста
Вывод времени публикации поста с заданным ID:
<?php echo get_the_time('', $post->ID); ?>
Пример 3: Получение метки времени в Unix формате
Чтобы получить метку времени Unix (количество секунд, прошедших с 1 января 1970 года) для даты публикации поста, используйте формат ‘U’:
<?php $local_timestamp = get_the_time('U'); ?>
Пример 4: Время в часовом поясе GMT
Для получения времени публикации в часовом поясе GMT, укажите второй параметр:
<?php $gmt_timestamp = get_the_time('U', true); ?>
Пример 5: Использование функции в цикле постов
if (have_posts()) :
while (have_posts()) : the_post();
// Выводим время публикации текущего поста в формате 'Y-m-d H:i:s'
echo 'Время публикации: ' . get_the_time('Y-m-d H:i:s');
endwhile;
endif;
Этот пример используется внутри цикла WordPress и выводит время публикации каждого поста в формате ‘Год-месяц-день Часы:Минуты:Секунды’.
Заключение
Функция get_the_time()
в WordPress предоставляет гибкие возможности для получения и отображения времени публикации постов. Благодаря параметрам форматирования и возможности указания ID поста, вы можете легко адаптировать вывод времени под различные требования вашего шаблона или плагина. Правильное использование функции позволяет обеспечить точное отображение информации о публикациях и улучшить взаимодействие пользователей с вашим сайтом.