archived-doc-ru/reference/datetime/constants.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b53f03f249fca24b7b1f32564e7dde31fa8b713e Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 <para>
  PHP определяет семейство констант <constant>DATE_<replaceable>*</replaceable></constant>,
  которые предлагают стандартные
  представления даты при работе с функциями форматирования
  даты наподобие функции <function>date</function>.
 </para>
 <variablelist>
  <title>
   Форматы возврата, доступные для параметра <parameter>returnFormat</parameter>
   функций <function>date_sunrise</function>
   и <function>date_sunset</function>
  </title>

  <warning>
   <simpara>
    Эти константы устарели с PHP 8.4.0.
    Функции <function>date_sunrise</function>
    и <function>date_sunset</function> устарели с PHP 8.1.0.
   </simpara>
  </warning>

  <varlistentry xml:id="constant.sunfuncs-ret-timestamp">
   <term>
    <constant>SUNFUNCS_RET_TIMESTAMP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Время в секундах с начала эпохи Unix.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.sunfuncs-ret-string">
   <term>
    <constant>SUNFUNCS_RET_STRING</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Часы:минуты, например: <literal>08:02</literal>.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="constant.sunfuncs-ret-double">
   <term>
    <constant>SUNFUNCS_RET_DOUBLE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Часы как число с плавающей точкой: <literal>8.75</literal>.
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
 <variablelist>
  <title><constant>Константы семейства DATE_<replaceable>*</replaceable></constant></title>
  <varlistentry xml:id="constant.date-atom">
   <term>
    <constant>DATE_ATOM</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате Atom: <literal>2005-08-15T15:52:01+00:00</literal>;
     формат совместим со стандартами ISO-8601, RFC 3339 и XML Schema.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-cookie">
   <term>
    <constant>DATE_COOKIE</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате блоков данных Cookies HTTP-протокола:
     <literal>Monday, 15-Aug-2005 15:52:01 UTC</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-iso8601">
   <term>
    <constant>DATE_ISO8601</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате, подобном стандарту ISO-8601: <literal>2005-08-15T15:52:01+0000</literal>.
    </simpara>
    <note>
     <simpara>
      Формат несовместим со стандартом ISO-8601, но сохранился
      по причинам обратной совместимости. Вместо этой константы указывают константы
      <constant>DATE_ISO8601_EXPANDED</constant>
      и <constant>DATE_ATOM</constant> для совместимости со стандартом ISO-8601
      (см. пункт d раздела 4.3.3 стандарта ISO8601:2004).
     </simpara>
    </note>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-iso8601-expanded">
   <term>
    <constant>DATE_ISO8601_EXPANDED</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате расширенного стандарта ISO-8601:
     <literal>+10191-07-26T08:59:52+01:00</literal>.
    </simpara>
    <note>
     <simpara>
      Этот формат, в отличие от стандартного диапазона лет по стандарту ISO-8601 —
      <literal>0000</literal>-<literal>9999</literal>, допускает диапазоны лет, за счёт
      включения знакового символа. Это также гарантирует, что часть, в которой указывается часовой пояс,
      (<literal>+01:00</literal>) совместима со стандартом ISO-8601.
     </simpara>
    </note>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc822">
   <term>
    <constant>DATE_RFC822</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате стандарта RFC 822: <literal>Mon, 15 Aug 05 15:52:01 +0000</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc850">
   <term>
    <constant>DATE_RFC850</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате стандарта RFC 850: <literal>Monday, 15-Aug-05 15:52:01 UTC</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc1036">
   <term>
    <constant>DATE_RFC1036</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате стандарта RFC 1036: <literal>Mon, 15 Aug 05 15:52:01 +0000</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc1123">
   <term>
    <constant>DATE_RFC1123</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате стандарта RFC 1123: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc7231">
    <term>
    <constant>DATE_RFC7231</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате стандарта RFC 7231 (начиная с PHP 7.0.19 и 7.1.5):
     <literal>Sat, 30 Apr 2016 17:52:13 GMT</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc2822">
   <term>
    <constant>DATE_RFC2822</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате стандарта RFC 2822: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc3339">
   <term>
    <constant>DATE_RFC3339</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     То же, что <constant>DATE_ATOM</constant>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rfc3339-extended">
   <term>
    <constant>DATE_RFC3339_EXTENDED</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в формате расширенного стандарта RFC 3339:
     <literal>2005-08-15T15:52:01.000+00:00</literal>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-rss">
   <term>
    <constant>DATE_RSS</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в RSS-формате: <literal>Mon, 15 Aug 2005 15:52:01 +0000</literal>.
     &Alias; константы <constant>DATE_RFC1123</constant>.
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="constant.date-w3c">
   <term>
    <constant>DATE_W3C</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Дата и время в W3C-формате: <literal>2005-08-15T15:52:01+00:00</literal>.
     &Alias; константы <constant>DATE_RFC3339</constant>.
    </simpara>
   </listitem>
  </varlistentry>

 </variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->