Дата и время в WordPress — Форматы даты и времени

В WordPress есть функции, которые получают дату или время записи, комментария или чего-то еще: the_date(), the_time(), mysql2date() и т.д. В каждую из таких функций можно передать формат, чтобы получить время или дату в нужном формате. В этой заметке показано, как получить любой формат и какие символы в указанном формате за что отвечают.

Простой пример: вывод на экран времени публикации записи:

<?php the_time('j F Y в H:i'); ?>

Выведет дату в виде: 1 апреля 2016 в 20:09.

Все символы формата даты и времени

А теперь, давайте рассмотрим все специальные символы, которые можно использовать в формате.

Примеры

Пример с функцией WordPress

Пост опубликован <?php the_time('j F Y в H:i') ?> и находится в рубриках <?php the_category(', ') ?>.

Выведет:

Пост опубликован 1 апреля 2016 в 20:09 и находится в рубриках WordPress, Кодекс.

Опции связанные с датами

var_dump( [
	'date_format'     => get_option( 'date_format' ),
	'time_format'     => get_option( 'time_format' ),
	'gmt_offset'      => get_option( 'gmt_offset' ), // may be string - depends on value of `timezone_string`
	'offset'          => (float) get_option( 'gmt_offset' ) * HOUR_IN_SECONDS,
	'start_of_week'   => (int) get_option( 'start_of_week', 0 ),
	'timezone_string' => get_option( 'timezone_string' ),
] );

/*
array(6) {
  ["date_format"]=> string(5) "j M Y"
  ["time_format"]=> string(3) "H:i"
  ["gmt_offset"]=> float(5)
  ["offset"]=> float(18000)
  ["start_of_week"]=> int(1)
  ["timezone_string"]=> string(0) "Asia/Tashkent"
}
*/

Экранирование

Если использовать символы не из таблицы, то они будут показаны как есть, например, в из примера выше. Но когда нужно, чтобы спецсимвол не обрабатывался (использовался как есть), его нужно экранировать обратным слэшем \.

echo get_the_time('j F Y - это формат \j \F \Y'); //> 1 апреля 2016 - это формат j F Y

Локализация

Для перевода строк в дате вроде: November на язык сайта, используется функция date_i18n().

Также, для локализации формата можно использовать стандартные функции локализации: __(), _e() и т.д. Например:

get_the_date( __('j F Y в H:i','dom') )