GET_DATE_FROM_GMT() │ WP 1.2.0

Функция GET_DATE_FROM_GMT() преобразует дату в формате GMT в правильный формат для вашего блога.

Описание функции

Эта функция принимает дату в формате Y-m-d H:i:s. По умолчанию результат будет возвращен в том же формате, но вы можете изменить его с помощью параметра $format.

Производительность

• Использует: get_option()
• Время выполнения: 1 раз — 0.000149 сек (быстро) | 50000 раз — 3.75 сек (быстро)

Хуки

Эта функция не использует хуки.

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

Функция возвращает строку — форматированную дату во временной зоне сайта.

Использование

get_date_from_gmt( $date_string, $format );

Параметры

• $date_string (string) (обязательный): Дата, которую нужно преобразовать, в формате UTC или GMT.
• $format (string): Строка формата для возвращаемой даты. По умолчанию: 'Y-m-d H:i:s'.

Примеры

Пример 1: Получение локального времени сайта из GMT времени

Этот пример будет работать, если на странице настройки (wp-admin/options-general.php) выбрана временная зона, например UTC+4.

echo get_date_from_gmt( '2015-09-25 13:56:43' );
// Вывод: 2015-09-25 17:56:43

Пример 2: Демонстрация использования

Эта функция не принимает Unix Timestamp, потому что функция date_create() не поддерживает его напрямую.

Если вам нужно использовать Unix Timestamp, сначала его нужно преобразовать в другой формат, например, так:

$utc_timestamp = 1623096269;

// Преобразуем в формат, который принимает date_create()
$utc_timestamp_converted = date( 'Y-m-d H:i:s', $utc_timestamp );

$output_format = 'Y-m-d H:i:s';

// Теперь можем использовать наш временной штамп
$local_timestamp = get_date_from_gmt( $utc_timestamp_converted, $output_format );

Изменения

С момента версии 1.2.0 функция была введена.

Исходный код

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

function get_date_from_gmt( $date_string, $format = 'Y-m-d H:i:s' ) {
$datetime = date_create( $date_string, new DateTimeZone( 'UTC' ) );

if ( false === $datetime ) {
    return gmdate( $format, 0 );
}

return $datetime->setTimezone( wp_timezone() )->format( $format );

}

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

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

• comment_date()
• comment_time()
• current_time()
• date_i18n()
• get_comment_date()
• get_comment_time()
• get_gmt_from_date()
• get_lastpostdate()
• get_lastpostmodified()
• get_post_time()
• get_post_timestamp()
• get_the_date()
• get_the_modified_date()
• get_the_modified_time()
• get_the_time()
• get_weekstartend()
• mysql2date()
• the_date()
• the_time()
• wp_checkdate()
• wp_date()
• wp_maybe_decline_date()
• wp_timezone()
• wp_timezone_choice()
• wp_timezone_string()

Таким образом, GET_DATE_FROM_GMT() — полезная функция для преобразования времени из GMT в местный формат блога, что позволяет вам правильно отображать даты в ваших постах и комментариях.