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

## Функция GET_THE_TIME() в WordPress

Функция get_the_time() возвращает время публикации текущей записи в заданном формате. Она исполь��уется внутри цикла WordPress, известного как Loop.

### Что делает эта функция?

- **Получает** время, когда была написана текущая запись, в нужном формате.
- Если нужно, вы можете получить время в виде Unix-метки времени.

### Параметры функции

```php
get_the_time( $format, $post );
  • $format (string): Формат для получения времени написания записи. Возможные варианты:

    • 'G' — время в 24-часовом формате (от 0 до 23).
    • 'U' — метка времени Unix.
    • Другие форматы, поддерживаемые PHP для даты/времени.

    По умолчанию используется формат времени, заданный в настройках WordPress.

  • $post (int|WP_Post): ID записи или объект записи. Если не указано, используется глобальный объект $post.

Результат работы функции

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

  • Строку или число: отформатированную дату или метку времени Unix, если аргумент $format равен 'U' или 'G'.
  • false: если произошла ошибка.

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

1. Основное использование

Получение времени публикации текущей записи в цикле. Формат даты будет таким, как указано в настройках WordPress.

$local_timestamp = get_the_time('U');

Если хотите получить время для конкретной записи, укажите её ID:

echo get_the_time('', $post->ID);

2. Получение времени в формате Unix

Чтобы получить метку времени Unix (число секунд с 1 января 1970 года до даты написания записи), используйте следующий код:

$local_timestamp = get_the_time('U');

3. Время в часовом поясе GMT

Если нужно получить время в часовом поясе GMT (UTC), добавьте второй параметр:

$gmt_timestamp = get_post_time('U', true);

Код функции

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


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

if ( ! $post ) {
    return false;
}

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

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

/**
 * Фильтрует время, когда была написана запись.
 *
 * @param string|int  $the_time Отформатированная строка илиUnix метка времени.
 * @param string      $format   Формат для получения времени публикации записи.
 * @param WP_Post     $post     Объект записи.
 */
return apply_filters( 'get_the_time', $the_time, $format, $post );

}

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

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

  • comment_date(): возвращает дату комментария.
  • current_time(): возвращает текущее время на сайте.
  • get_post_time(): получает время написания записи.

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

Leave a Reply

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