Интерфейс DateTimeInterface
DateTimeInterface
&reftitle.intro;
Интерфейс DateTimeInterface разработали,
чтобы объявления типов параметров, значений возврата или свойств
принимали как значение объекты классов DateTimeImmutable
и DateTime.
Реализовать интерфейс в пользовательских классах невозможно.
В интерфейсе также определили общие константы
для форматирования объектов
DateTimeImmutable и DateTime
методами DateTimeImmutable::format
и DateTime::format.
&reftitle.interfacesynopsis;
DateTimeInterface
&Constants;
public
const
string
DateTimeInterface::ATOM
"Y-m-d\\TH:i:sP"
public
const
string
DateTimeInterface::COOKIE
"l, d-M-Y H:i:s T"
public
const
string
DateTimeInterface::ISO8601
"Y-m-d\\TH:i:sO"
public
const
string
DateTimeInterface::ISO8601_EXPANDED
"X-m-d\\TH:i:sP"
public
const
string
DateTimeInterface::RFC822
"D, d M y H:i:s O"
public
const
string
DateTimeInterface::RFC850
"l, d-M-y H:i:s T"
public
const
string
DateTimeInterface::RFC1036
"D, d M y H:i:s O"
public
const
string
DateTimeInterface::RFC1123
"D, d M Y H:i:s O"
public
const
string
DateTimeInterface::RFC7231
"D, d M Y H:i:s \\G\\M\\T"
public
const
string
DateTimeInterface::RFC2822
"D, d M Y H:i:s O"
public
const
string
DateTimeInterface::RFC3339
"Y-m-d\\TH:i:sP"
public
const
string
DateTimeInterface::RFC3339_EXTENDED
"Y-m-d\\TH:i:s.vP"
public
const
string
DateTimeInterface::RSS
"D, d M Y H:i:s O"
public
const
string
DateTimeInterface::W3C
"Y-m-d\\TH:i:sP"
&Methods;
&reftitle.constants;
DateTimeInterface::ATOM
string
DATE_ATOM
Дата и время в формате стандарта Atom: 2005-08-15T15:52:01+00:00;
формат совместим со стандартами ISO-8601, RFC 3339 и XML Schema.
DateTimeInterface::COOKIE
string
DATE_COOKIE
Дата и время для установки с блоках данных cookies HTTP-протокола:
Monday, 15-Aug-05 15:52:01 UTC
DateTimeInterface::ISO8601
string
DATE_ISO8601
Дата и время в формате, аналогичном стандарту ISO-8601: 2005-08-15T15:52:01+0000.
Формат несовместим со стандартом ISO-8601, но остаётся по соображениям обратной совместимости.
Для совместимости со стандартом ISO-8601 указывают константу
DateTimeInterface::ISO8601_EXPANDED или DateTimeInterface::ATOM.
См. пункт d раздела 4.3.3 стандарта ISO8601:2004.
DateTimeInterface::ISO8601_EXPANDED
string
DATE_ISO8601_EXPANDED
Дата и время по стандарту ISO-8601 Expanded: +10191-07-26T08:59:52+01:00
За счёт включения знакового символа формат принимает диапазоны лет за пределами
нормального диапазона стандарта ISO-8601 — 0000-9999.
Формат гарантирует, что часть +01:00 с обозначением часового пояса
совместима со стандартом ISO-8601.
DateTimeInterface::RFC822
string
DATE_RFC822
Дата и время по стандарту RFC 822: Mon, 15 Aug 05 15:52:01 +0000
DateTimeInterface::RFC850
string
DATE_RFC850
Дата и время по стандарту RFC 850: Monday, 15-Aug-05 15:52:01 UTC
DateTimeInterface::RFC1036
string
DATE_RFC1036
Дата и время по стандарту RFC 1036: Mon, 15 Aug 05 15:52:01 +0000
DateTimeInterface::RFC1123
string
DATE_RFC1123
Дата и время по стандарту RFC 1123: Mon, 15 Aug 2005 15:52:01 +0000
DateTimeInterface::RFC7231
string
DATE_RFC7231
Дата и время по стандарту RFC 7231: Sat, 30 Apr 2016 17:52:13 GMT.
Константа доступна с PHP 7.0.19 и 7.1.5
DateTimeInterface::RFC2822
string
DATE_RFC2822
Дата и время по стандарту RFC 2822: Mon, 15 Aug 2005 15:52:01 +0000
DateTimeInterface::RFC3339
string
DATE_RFC3339
То же, что и DATE_ATOM
DateTimeInterface::RFC3339_EXTENDED
string
DATE_RFC3339_EXTENDED
Дата и время по стандарту RFC 3339 EXTENDED: 2005-08-15T15:52:01.000+00:00
DateTimeInterface::RSS
string
DATE_RSS
Дата и время в RSS-формате: Mon, 15 Aug 2005 15:52:01 +0000
DateTimeInterface::W3C
string
DATE_W3C
Дата и время в формате W3C (англ. World Wide Web Consortium): 2005-08-15T15:52:01+00:00
&reftitle.changelog;
&Version;
&Description;
8.4.0
Константы класса стали типизированными.
8.2.0
Добавили константу
DateTimeInterface::ISO8601_EXPANDED.
7.2.0
Константы класса DateTime теперь определяются
в интерфейсе DateTimeInterface.
&reference.datetime.entities.datetimeinterface;