DateTime::formatDateTimeImmutable::formatDateTimeInterface::formatdate_formatВозвращает дату, отформатированную согласно переданному формату
&reftitle.description;
&style.oop;publicstringDateTime::formatstringformatpublicstringDateTimeImmutable::formatstringformatpublicstringDateTimeInterface::formatstringformat&style.procedural;stringdate_formatDateTimeInterfaceobjectstringformat
Возвращает строку даты, преобразованной согласно переданному формату.
&reftitle.parameters;
&date.datetime.description;
format
Шаблон результирующей строки (string) с датой. См. параметры
форматирования ниже. Также существует несколько предопределённых констант даты/времени,
которые могут быть использованы вместо этих параметров. Например:
DATE_RSS заменяет шаблон 'D, d M Y H:i:s'.
В параметре format распознаются
следующие символыСимвол в строке formatОписаниеПример возвращаемого значенияДень------dДень месяца, 2 цифры с ведущим нулёмот 01 до 31DТекстовое представление дня недели, 3 символаот Mon до SunjДень месяца без ведущего нуляот 1 до 31l (строчная 'L')Полное наименование дня неделиот Sunday до SaturdayNПорядковый номер дня недели в соответствии со
стандартом ISO-8601от 1 (понедельник) до 7 (воскресенье)SАнглийский суффикс порядкового числительного дня месяца, 2 символаst, nd, rd или
th. Применяется совместно с jwПорядковый номер дня неделиот 0 (воскресенье) до 6 (суббота)zПорядковый номер дня в году (начиная с 0)От 0 до 365Неделя------WПорядковый номер недели года в соответствии со стандартом
ISO-8601; недели начинаются с понедельникаНапример: 42 (42-я неделя года)Месяц------FПолное наименование месяца, например, January или Marchот January до DecembermПорядковый номер месяца с ведущим нулёмот 01 до 12MСокращённое наименование месяца, 3 символаот Jan до DecnПорядковый номер месяца без ведущего нуляот 1 до 12tКоличество дней в указанном месяцеот 28 до 31Год------LПризнак високосного года1, если год високосный, иначе 0.oНомер года в соответствии со стандартом ISO-8601. Имеет то же значение, что и
Y, кроме случая, когда номер недели ISO
(W) принадлежит предыдущему или следующему году; тогда
будет использован год этой недели.Примеры: 1999 или 2003YПорядковый номер года, 4 цифрыПримеры: 1999, 2003yНомер года, 2 цифрыПримеры: 99, 03Время------aAnte meridiem (лат. "до полудня") или Post meridiem (лат. "после полудня")
в нижнем регистреam или pmAAnte meridiem или Post meridiem в верхнем регистреAM или PMBВремя в формате Интернет-времени (альтернативной системы отсчёта времени суток)от 000 до 999gЧасы в 12-часовом формате без ведущего нуляот 1 до 12GЧасы в 24-часовом формате без ведущего нуляот 0 до 23hЧасы в 12-часовом формате с ведущим нулёмот 01 до 12HЧасы в 24-часовом формате с ведущим нулёмот 00 до 23iМинуты с ведущим нулёмот 00 до 59sСекунды с ведущим нулёмот 00 до 59u
Микросекунды. Учтите, что date
всегда будет возвращать 000000, т.к. она принимает целочисленный (int)
параметр, тогда как DateTime::format поддерживает
микросекунды, если DateTime создан с ними.
Например: 654321v
Миллисекунды. Замечание такое же как и для
u.
Пример: 654Временная зона------eИдентификатор временной зоныПримеры: UTC, GMT, Atlantic/AzoresI (заглавная i)Признак летнего времени1, если дата соответствует летнему времени, 0 в противном случае.OРазница с временем по Гринвичу без двоеточия между часами и минутамиНапример: +0200PРазница с временем по Гринвичу с двоеточием между часами и минутамиНапример: +02:00pТо же, что и P, но возвращает Z вместо +00:00Например: +02:00TАббревиатура временной зоныПримеры: EST, MDT ...ZСмещение временной зоны в секундах. Для временных зон,
расположенных западнее UTC возвращаются отрицательные числа,
а расположенных восточнее UTC - положительные.от -43200 до 50400Полная дата/время------cДата в формате стандарта ISO 86012004-02-12T15:19:21+00:00rДата в формате RFC 2822Например: Thu, 21 Dec 2000 16:01:07 +0200UКоличество секунд, прошедших с начала Эпохи Unix (1 января 1970 00:00:00 GMT)Смотрите также time
Любые другие символы, встреченные в строке-шаблоне, будут выведены в результирующую
строку без изменений. Z всегда возвращает 0 при
использовании gmdate.
Поскольку рассматриваемая функция принимает в качестве параметра временные метки
типа int, форматирующий символ u будет полезен
только при использовании функции date_format и пользовательских
меток времени, созданных с помощью функции date_create.
&reftitle.returnvalues;
Возвращает строку с отформатированной датой в случае успешного выполнения.
&reftitle.changelog;
&Version;&Description;8.0.0
До этой версии, в случае возникновения ошибки возвращалось &false;.
8.0.0
Добавлен символ форматирования p.
&reftitle.examples;
Пример использования DateTime::format&style.oop;
format('Y-m-d H:i:s');
?>
]]>
&style.procedural;
]]>
&example.outputs;
&reftitle.notes;
Данный метод не использует настройки локали. Вывод производится на английском языке.
&reftitle.seealso;
date