DateTime::format
DateTimeImmutable::format
DateTimeInterface::format
date_format
(PHP 5 >= 5.2.1, PHP 7)
DateTime::format -- DateTimeImmutable::format -- DateTimeInterface::format -- date_format — Возвращает дату, отформатированную согласно переданному формату
Описание
Объектно-ориентированный стиль
$format
) : string$format
) : string$format
) : stringПроцедурный стиль
Возвращает строку даты, преобразованной согласно переданному формату.
Список параметров
-
object -
Только для процедурного стиля: Объект DateTime, возвращаемый date_create()
-
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Миллисекунды (добавлено в PHP 7.0.0). Замечание такое же как и для 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 8601 2004-02-12T15:19:21+00:00 rДата в формате » 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().
Возвращаемые значения
Возвращает строку с отформатированной датой в случае успешного выполнения.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
До этой версии, в случае возникновения ошибки возвращалось false.
|
Примеры
Пример #1 Пример использования DateTime::format()
Объектно-ориентированный стиль
<?php
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:s');
?>
Процедурный стиль
<?php
$date = date_create('2000-01-01');
echo date_format($date, 'Y-m-d H:i:s');
?>
Результат выполнения данного примера:
2000-01-01 00:00:00
Примечания
Данный метод не использует настройки локали. Вывод производится на английском языке.
Смотрите также
- date() - Форматирует вывод системной даты/времени