php-doc-en/reference/datetime/dateinterval/construct.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->

<refentry xml:id="dateinterval.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>DateInterval::__construct</refname>
  <refpurpose>Creates a new DateInterval object</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <constructorsynopsis role="oop">
   <modifier>public</modifier> <methodname>DateInterval::__construct</methodname>
   <methodparam><type>string</type><parameter>interval_spec</parameter></methodparam>
  </constructorsynopsis>
  <para>
   Creates a new DateInterval object.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>interval_spec</parameter></term>
     <listitem>
      <para>
       An interval specification.
      </para>
      <para>
       The format starts with the letter <literal>P</literal>,
       for <quote>period.</quote>
       Each duration period is represented by an integer value
       followed by a period designator.
       If the duration contains time elements, that portion
       of the specification is preceded by the letter
       <literal>T</literal>.
      </para>
      <para>
       <table>
        <title>
         <parameter>interval_spec</parameter> Period Designators
        </title>
        <tgroup cols="2">
         <thead>
          <row>
           <entry>Period Designator</entry>
           <entry>Description</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry><literal>Y</literal></entry>
           <entry>years</entry>
          </row>
          <row>
           <entry><literal>M</literal></entry>
           <entry>months</entry>
          </row>
          <row>
           <entry><literal>D</literal></entry>
           <entry>days</entry>
          </row>
          <row>
           <entry><literal>W</literal></entry>
           <entry>
            weeks. These get converted into days,
            so can not be combined with <literal>D</literal>.
           </entry>
          </row>
          <row>
           <entry><literal>H</literal></entry>
           <entry>hours</entry>
          </row>
          <row>
           <entry><literal>M</literal></entry>
           <entry>minutes</entry>
          </row>
          <row>
           <entry><literal>S</literal></entry>
           <entry>seconds</entry>
          </row>
         </tbody>
        </tgroup>
       </table>
      </para>
      <para>
       Here are some simple examples.
       Two days is <literal>P2D</literal>.
       Two seconds is <literal>PT2S</literal>.
       Six years and five minutes is <literal>P6YT5M</literal>.
      </para>
      <note>
       <para>
        The unit types must be entered from the largest
        scale unit on the left to the smallest scale unit
        on the right.
        So years before months, months before days,
        days before minutes, etc.
        Thus one year and four days must be represented as
        <literal>P1Y4D</literal>, not <literal>P4D1Y</literal>.
       </para>
      </note>
      <para>
       The specification can also be represented as a date time.
       A sample of one year and four days would be
       <literal>P0001-00-04T00:00:00</literal>.
       But the values in this format can not exceed a given period's
       roll-over-point (e.g. <literal>25</literal> hours is invalid).
      </para>
      <para>
       These formats are based on the <link
        xlink:href="&url.iso-8601.duration;">ISO 8601 duration
       specification</link>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="errors">
  &reftitle.errors;
  <para>
   Throws an <classname>Exception</classname> when the <parameter>interval_spec</parameter>
   cannot be parsed as an interval.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><classname>DateInterval</classname> example</title>
    <programlisting role="php">
<![CDATA[
<?php

$interval = new DateInterval('P2Y4DT6H8M');
var_dump($interval);

?>
]]>
    </programlisting>
    &example.outputs;
    <screen role="php">
<![CDATA[
object(DateInterval)#1 (8) {
  ["y"]=>
  int(2)
  ["m"]=>
  int(0)
  ["d"]=>
  int(4)
  ["h"]=>
  int(6)
  ["i"]=>
  int(8)
  ["s"]=>
  int(0)
  ["invert"]=>
  int(0)
  ["days"]=>
  bool(false)
}
]]>
    </screen>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>DateInterval::format</function></member>
    <member><function>DateTime::add</function></member>
    <member><function>DateTime::sub</function></member>
    <member><function>DateTime::diff</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>

<!-- 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
-->