Документация для разработчиков
Темная тема

FormatDate

Описание и параметры

string
FormatDate(
	string format,
	int timestamp,
	int now = time(),
);

Функция возвращает строку отформатированную в соответствии с заданным форматом основываясь на значении времени выраженного в timestamp.

Примечание: фактически эта функция является оберткой для php функции date.

Параметры метода

Параметр Описание С версии
format Формат даты/времени. Кроме стандартных символов поддерживаются расширения:
ФорматЗначениеПример
sagoN секунд назад2 секунды назад
sdiffN секунд1 секунда
iagoN минут назад11 минут назад
idiffN минут32 минуты
isagoN минут M секунд назад4 минуты 12 секунд назад
HagoN часов назад1 час назад
HdiffN часов3 часа
yesterdayконстантавчера
todayконстантасегодня
dagoN дней назад2 дня назад
ddiffN дней8 дней
mdiffN месяцев6 месяцев
YdiffN лет2 года
Fназвание месяца в родительном падежеЯнваря
fназвание месяца в именительном падежеЯнварь
Mсокращенное название месяцаЯнв
lназвание дня неделиВоскресенье
Dсокращенное название дня неделиВс
xинтервал времени в зависимости от его величины.32 секунды назад
49 минут назад
сегодня, 14:33
вчера, 12:32
или в формате сайта без секунд.
Xинтервал времени в зависимости от его величины.сегодня
вчера
или в формате сайта без секунд.
Qинтервал времени в зависимости от его величины.1 день
22 дня
3 месяца
12 лет
timestampметка времени в Unix формате
now метка времени в unix формате от которой будут вычисляться интервалы. По умолчанию - time(). 9.5.7

Примечания

В форматах 'x' и 'X' реализована поддержка будущего времени. Если значение параметра timestamp больше значения параметра now (находится в будущем), то форматы "X" и "x" вернут время в формате сайта без секунд.

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

Отформатированная строка.

Смотрите также

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

<?
$rsUser = CUser::GetList($by, $order, array(
	"ID_EQUAL_EXACT" => $USER->GetID()
));
if($arUser = $rsUser->Fetch())
{
	echo "Зарегистрирован на сайте: ",FormatDate("Q", MakeTimeStamp($arUser["DATE_REGISTER"])),".";
}
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024