FormatDate

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

The function returns string, formatted in accordance with the specified format based on the time value, defined in the timestamp.

Note: in practice this function acts as wrapper for PHP function date.

Method parameters

Parameter	Description	Available from version
format	Data/time format. The following extensions are supported in addition to the standard symbols: Format Value Example sago N seconds back 2 seconds ago sdiff N seconds 1 second iago N minutes ago 11 minutes ago idiff N minutes 32 minutes isago N minutes M seconds ago 4 minutes 12 seconds ago Hago N hours ago 1 hour ago Hdiff N hours 3 hours yesterday constant yesterday today constant today dago N days ago 2 days ago ddiff N days 8 days mdiff N months 6 months Ydiff N years 2 years F month name in genitive case of January f month name in nominative case January M abbreviated month name Jan l weekday name Sunday D abbreviated weekday name Sun x time interval depending on its size. 32 seconds ago 49 minutes ago today, 14:33 yesterday, 12:32 or in site format without seconds. X time interval depending on its size. today yesterday or in site format without seconds. Q time interval depending on its size. 1 day 22 days 3 months 12 years
timestamp	timestamp in Unix format
now	timestamp in Unix format that is used to calculate intervals. By default - time().

Notes

The 'x' and 'X' formats supports future time specs. If the value of the timestamp parameter is higher than the value of the now parameter (i.e future time is specified), the formats "X" and "x" will return time in the site format without seconds.

Returned value

Formatted string.

See Also

• MakeTimeStamp

Examples of use

<?
$rsUser = CUser::GetList($by, $order, array(
  "ID_EQUAL_EXACT" => $USER->GetID()
));
if($arUser = $rsUser->Fetch())
{
  echo "Registered on site: ",FormatDate("Q", MakeTimeStamp($arUser["DATE_REGISTER"])),".";
}
?>