repo_zf1/documentation/manual/en/module_specs/Zend_Date-Constants.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<sect1 id="zend.date.constants">
    <title>Constants for General Date Functions</title>

    <para>
        Whenever a <classname>Zend_Date</classname> method has a <varname>$parts</varname>
        parameter, one of the constants below can be used as the argument for that parameter, in
        order to select a specific part of a date or indicate the date format used or desired (e.g.
        <acronym>RFC</acronym> 822).
    </para>

    <sect2 id="zend.date.constants.using">
        <title>Using Constants</title>

        <para>
            For example, the constant <constant>Zend_Date::HOUR</constant> can be used in the ways
            shown below. When working with days of the week, calendar dates, hours, minutes,
            seconds, and any other date parts that are expressed differently when in different parts
            of the world, the object's timezone will automatically be used to compute the correct
            value, even though the internal timestamp is the same for the same moment in time,
            regardless of the user's physical location in the world. Regardless of the units
            involved, output must be expressed either as <acronym>GMT</acronym> or
            <acronym>UTC</acronym> or localized to a locale. The example output below reflects
            localization to Europe/GMT+1 hour (e.g. Germany, Austria, France).
        </para>

        <table id="zend.date.constants.using.table">
            <title>Operations Involving Zend_Date::HOUR</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Method</entry>
                        <entry>Description</entry>
                        <entry>Original date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><methodname>get(Zend_Date::HOUR)</methodname></entry>
                        <entry>Output of the hour</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>14</entry>
                    </row>
                    <row>
                        <entry><methodname>set(12, Zend_Date::HOUR)</methodname></entry>
                        <entry>Set new hour</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>2009-02-13T12:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry><methodname>add(12, Zend_Date::HOUR)</methodname></entry>
                        <entry>Add hours</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>2009-02-14T02:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry><methodname>sub(12, Zend_Date::HOUR)</methodname></entry>
                        <entry>Subtract hours</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>2009-02-13T02:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry><methodname>compare(12, Zend_Date::HOUR)</methodname></entry>
                        <entry>Compare hour, returns 0, 1 or -1</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>1 (if object > argument)</entry>
                    </row>
                    <row>
                        <entry><methodname>copy(Zend_Date::HOUR)</methodname></entry>
                        <entry>Copies only the hour part</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>1970-01-01T14:00:00+01:00</entry>
                    </row>
                    <row>
                        <entry><methodname>equals(14, Zend_Date::HOUR)</methodname></entry>
                        <entry>Compares the hour, returns <constant>TRUE</constant> or
                        <constant>FALSE</constant></entry> <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><constant>TRUE</constant></entry>
                    </row>
                    <row>
                        <entry><methodname>isEarlier(12, Zend_Date::HOUR)</methodname></entry>
                        <entry>Compares the hour, returns <constant>TRUE</constant> or
                        <constant>FALSE</constant></entry> <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><constant>TRUE</constant></entry>
                    </row>
                    <row>
                        <entry><methodname>isLater(12, Zend_Date::HOUR)</methodname></entry>
                        <entry>Compares the hour, returns <constant>TRUE</constant> or
                        <constant>FALSE</constant></entry> <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><constant>FALSE</constant></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

    </sect2>

    <sect2 id="zend.date.constants.list">
        <title>List of All Constants</title>

        <para>
            Each part of a date or time has a unique constant in <classname>Zend_Date</classname>.
            All constants supported by <classname>Zend_Date</classname> are listed below.
        </para>

        <table id="zend.date.constants.list.table-1">
            <title>Day Constants</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::DAY</constant></entry>
                        <entry>Day (as a number, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>
                            <emphasis>06</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DAY_SHORT</constant></entry>
                        <entry>Day (as a number, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>
                            <emphasis>6</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::WEEKDAY</constant></entry>
                        <entry>Weekday (Name of the day, localized, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>Friday</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::WEEKDAY_SHORT</constant></entry>
                        <entry>
                            Weekday (Name of the day, localized, abbreviated, the first three
                            digits)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>Fri</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::WEEKDAY_NAME</constant></entry>
                        <entry>
                            Weekday (Name of the day, localized, abbreviated, the first two digits)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>Fr</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::WEEKDAY_NARROW</constant></entry>
                        <entry>
                            Weekday (Name of the day, localized, abbreviated, only the first digit)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>F</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::WEEKDAY_DIGIT</constant></entry>
                        <entry>Weekday (0 = Sunday, 6 = Saturday)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>5</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::WEEKDAY_8601</constant></entry>
                        <entry>
                            Weekday according to <acronym>ISO</acronym> 8601 (1 = Monday, 7 =
                            Sunday)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>5</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DAY_OF_YEAR</constant></entry>
                        <entry>Day (as a number, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>43</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DAY_SUFFIX</constant></entry>
                        <entry>English addendum for the day (st, nd, rd, th)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>th</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <table id="zend.date.constants.list.table-2">
            <title>Week Constants</title>
            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><constant>Zend_Date::WEEK</constant></entry>
                        <entry>Week (as a number, 1-53)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>7</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <table id="zend.date.constants.list.table-3">
            <title>Month Constants</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::MONTH_NAME</constant></entry>
                        <entry>Month (Name of the month, localized, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>February</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MONTH_NAME_SHORT</constant></entry>
                        <entry>
                            Month (Name of the month, localized, abbreviated, three digit)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>Feb</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MONTH_NAME_NARROW</constant></entry>
                        <entry>Month (Name of the month, localized, abbreviated, one digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>F</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MONTH</constant></entry>
                        <entry>Month (Number of the month, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-<emphasis>02</emphasis>-06T14:53:27+01:00 (02)</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MONTH_SHORT</constant></entry>
                        <entry>Month (Number of the month, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-0<emphasis>2</emphasis>-06T14:53:27+01:00 (2)</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MONTH_DAYS</constant></entry>
                        <entry>Number of days for this month (number)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>28</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <table id="zend.date.constants.list.table-4">
            <title>Year Constants</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::YEAR</constant></entry>
                        <entry>Year (number)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>2009</emphasis>-02-06T14:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::YEAR_8601</constant></entry>
                        <entry>Year according to <acronym>ISO</acronym> 8601 (number)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::YEAR_SHORT</constant></entry>
                        <entry>Year (number, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>20<emphasis>09</emphasis>-02-06T14:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::YEAR_SHORT_8601</constant></entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601 (number, two digit)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::LEAPYEAR</constant></entry>
                        <entry>
                            Is the year a leap year? (<constant>TRUE</constant> or
                            <constant>FALSE</constant>)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><constant>FALSE</constant></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <table id="zend.date.constants.list.table-5">
            <title>Time Constants</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::HOUR</constant></entry>
                        <entry>Hour (00-23, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>14</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::HOUR_SHORT</constant></entry>
                        <entry>Hour (0-23, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>14</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::HOUR_SHORT_AM</constant></entry>
                        <entry>Hour (1-12, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::HOUR_AM</constant></entry>
                        <entry>Hour (01-12, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MINUTE</constant></entry>
                        <entry>Minute (00-59, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-02-06T14:<emphasis>53</emphasis>:27+01:00</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MINUTE_SHORT</constant></entry>
                        <entry>Minute (0-59, one or two digit)</entry>
                        <entry>2009-02-06T14:03:27+01:00</entry>
                        <entry>2009-02-06T14:0<emphasis>3</emphasis>:27+01:00</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::SECOND</constant></entry>
                        <entry>Second (00-59, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-02-06T14:53:<emphasis>27</emphasis>+01:00</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::SECOND_SHORT</constant></entry>
                        <entry>Second (0-59, one or two digit)</entry>
                        <entry>2009-02-06T14:53:07+01:00</entry>
                        <entry>2009-02-06T14:53:0<emphasis>7</emphasis>+01:00</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MILLISECOND</constant></entry>
                        <entry>Millisecond (theoretically infinite)</entry>
                        <entry><command>2009-02-06T14:53:27.20546</command></entry>
                        <entry>2009-02-06T14:53:27.<emphasis>20546</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::MERIDIEM</constant></entry>
                        <entry>Time of day (forenoon or afternoon)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>afternoon</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::SWATCH</constant></entry>
                        <entry>Swatch Internet Time</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>620</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <table id="zend.date.constants.list.table-6">
            <title>Timezone Constants</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::TIMEZONE</constant></entry>
                        <entry>Name der time zone (string, abbreviated)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis><acronym>CET</acronym></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIMEZONE_NAME</constant></entry>
                        <entry>Name of the time zone (string, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis><command>Europe/Paris</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIMEZONE_SECS</constant></entry>
                        <entry>
                            Difference of the time zone to <acronym>GMT</acronym> in seconds
                            (integer)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>3600</emphasis> seconds to <acronym>GMT</acronym></entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::GMT_DIFF</constant></entry>
                        <entry>Difference to <acronym>GMT</acronym> in seconds (string)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::GMT_DIFF_SEP</constant></entry>
                        <entry>
                            Difference to <acronym>GMT</acronym> in seconds (string, separated)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DAYLIGHT</constant></entry>
                        <entry>
                            Summer time or Winter time? (<constant>TRUE</constant> or
                            <constant>FALSE</constant>)
                        </entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><constant>FALSE</constant></entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <table id="zend.date.constants.list.table-7">
            <title>Date Format Constants (formats include timezone)</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::ISO_8601</constant></entry>
                        <entry>
                            Date according to <acronym>ISO</acronym> 8601 (string, complete)
                        </entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>2009-02-13T14:53:27+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::RFC_2822</constant></entry>
                        <entry>Date according to <acronym>RFC</acronym> 2822 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIMESTAMP</constant></entry>
                        <entry>
                            <ulink url="http://en.wikipedia.org/wiki/Unix_Time">Unix time</ulink>
                            (seconds since 1.1.1970, mixed)
                        </entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>1234533207</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::ATOM</constant></entry>
                        <entry>Date according to <acronym>ATOM</acronym> (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>2009-02-13T14:53:27+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::COOKIE</constant></entry>
                        <entry>Date for Cookies (string, for Cookies)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>
                            <emphasis><command>Friday, 13-Feb-09 14:53:27
                                Europe/Paris</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::RFC_822</constant></entry>
                        <entry>Date according to <acronym>RFC</acronym> 822 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>Fri, 13 Feb 09 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::RFC_850</constant></entry>
                        <entry>Date according to <acronym>RFC</acronym> 850 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>
                            <emphasis><command>Friday, 13-Feb-09 14:53:27
                                Europe/Paris</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::RFC_1036</constant></entry>
                        <entry>Date according to <acronym>RFC</acronym> 1036 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>Fri, 13 Feb 09 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::RFC_1123</constant></entry>
                        <entry>Date according to <acronym>RFC</acronym> 1123 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::RSS</constant></entry>
                        <entry>Date for <acronym>RSS</acronym> Feeds (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::W3C</constant></entry>
                        <entry>
                            Date for <acronym>HTML</acronym> or <acronym>HTTP</acronym> according
                            to <acronym>W3C</acronym> (string)
                        </entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>2009-02-13T14:53:27+01:00</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <para>
            Especially note <constant>Zend_Date::DATES</constant>, since this format specifier has
            a unique property within <classname>Zend_Date</classname> as an
            <emphasis>input</emphasis> format specifier. When used as an input format for
            <varname>$part</varname>, this constant provides the most flexible acceptance of a
            variety of similar date formats. Heuristics are used to automatically extract dates from
            an input string and then "fix" simple errors in dates (if any), such as swapping of
            years, months, and days, when possible.
        </para>

        <table id="zend.date.constants.list.table-8">
            <title>Date and Time Formats (format varies by locale)</title>

            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Date</entry>
                        <entry>Result</entry>
                    </row>
                </thead>

                <tbody>
                    <row>
                        <entry><constant>Zend_Date::ERA</constant></entry>
                        <entry>Epoch (string, localized, abbreviated)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>AD</emphasis> (anno Domini)</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::ERA_NAME</constant></entry>
                        <entry>Epoch (string, localized, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis>anno domini</emphasis> (anno Domini)</entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATES</constant></entry>
                        <entry>Standard date (string, localized, default value).</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13.02.2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATE_FULL</constant></entry>
                        <entry>Complete date (string, localized, complete)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>Friday, 13. February 2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATE_LONG</constant></entry>
                        <entry>Long date (string, localized, long)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13. February 2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATE_MEDIUM</constant></entry>
                        <entry>Normal date (string, localized, normal)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13.02.2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATE_SHORT</constant></entry>
                        <entry>Abbreviated Date (string, localized, abbreviated)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13.02.09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIMES</constant></entry>
                        <entry>Standard time (string, localized, default value)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>14:53:27</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIME_FULL</constant></entry>
                        <entry>Complete time (string, localized, complete)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis><command>14:53 Uhr CET</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIME_LONG</constant></entry>
                        <entry>Long time (string, localized, Long)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis><command>14:53:27 CET</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIME_MEDIUM</constant></entry>
                        <entry>Normal time (string, localized, normal)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>14:53:27</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::TIME_SHORT</constant></entry>
                        <entry>Abbreviated time (string, localized, abbreviated)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>14:53</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATETIME</constant></entry>
                        <entry>Standard date with time (string, localized, default value).</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13.02.2009 14:53:27</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATETIME_FULL</constant></entry>
                        <entry>Complete date with time (string, localized, complete)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>
                            <emphasis><command>Friday, 13. February 2009 14:53 Uhr
                                CET</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATETIME_LONG</constant></entry>
                        <entry>Long date with time (string, localized, long)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>
                            <emphasis><command>13. February 2009 14:53:27 CET</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATETIME_MEDIUM</constant></entry>
                        <entry>Normal date with time (string, localized, normal)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13.02.2009 14:53:27</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>Zend_Date::DATETIME_SHORT</constant></entry>
                        <entry>Abbreviated date with time (string, localized, abbreviated)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis>13.02.09 14:53</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

    </sect2>

    <sect2 id="zend.date.constants.selfdefinedformats">

        <title>Self-Defined OUTPUT Formats with ISO</title>

        <para>
            If you need a date format not shown above, then use a self-defined format composed from
            the <acronym>ISO</acronym> format token specifiers below. The following examples
            illustrate the usage of constants from the table below to create self-defined
            <acronym>ISO</acronym> formats. The format length is unlimited. Also, multiple usage of
            format constants is allowed.
        </para>

        <para>
            The accepted format specifiers can be changed from <acronym>ISO</acronym> Format to
            <acronym>PHP</acronym>'s date format if you are more comfortable with it. However, not
            all formats defined in the <acronym>ISO</acronym> norm are supported with
            <acronym>PHP</acronym>'s date format specifiers. Use the
            <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname> method to
            switch <classname>Zend_Date</classname> methods from supporting <acronym>ISO</acronym>
            format specifiers to <acronym>PHP</acronym> <methodname>date()</methodname> type
            specifiers (see <xref linkend="zend.date.constants.phpformats" /> below).
        </para>

        <example id="zend.date.constants.selfdefinedformats.example-1">
            <title>Self-Defined ISO Formats</title>
            <programlisting language="php"><![CDATA[
$locale = new Zend_Locale('de_AT');
$date = new Zend_Date(1234567890, false, $locale);
print $date->toString("'Era:GGGG='GGGG, ' Date:yy.MMMM.dd'yy.MMMM.dd");
]]></programlisting>
        </example>

        <table id="zend.date.constants.selfdefinedformats.table">
            <title>Constants for ISO 8601 Date Output</title>
            <tgroup cols="4">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Corresponds best to</entry>
                        <entry>Result</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>G</entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::ERA</constant></entry>
                        <entry><emphasis>AD</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>GG</entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::ERA</constant></entry>
                        <entry><emphasis>AD</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>GGG</constant></entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::ERA</constant></entry>
                        <entry><emphasis>AD</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>GGGG</constant></entry>
                        <entry>Epoch, localized, complete</entry>
                        <entry><constant>Zend_Date::ERA_NAME</constant></entry>
                        <entry><emphasis>anno domini</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>GGGGG</constant></entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::ERA</constant></entry>
                        <entry><emphasis>a</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>y</entry>
                        <entry>Year, at least one digit</entry>
                        <entry><constant>Zend_Date::YEAR</constant></entry>
                        <entry><emphasis>9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yy</entry>
                        <entry>Year, at least two digit</entry>
                        <entry><constant>Zend_Date::YEAR_SHORT</constant></entry>
                        <entry><emphasis>09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yyy</entry>
                        <entry>Year, at least three digit</entry>
                        <entry><constant>Zend_Date::YEAR</constant></entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yyyy</entry>
                        <entry>Year, at least four digit</entry>
                        <entry><constant>Zend_Date::YEAR</constant></entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yyyyy</entry>
                        <entry>Year, at least five digit</entry>
                        <entry><constant>Zend_Date::YEAR</constant></entry>
                        <entry><emphasis>02009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Y</entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601, at least one digit
                        </entry>
                        <entry><constant>Zend_Date::YEAR_8601</constant></entry>
                        <entry><emphasis>9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>YY</entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601, at least two digit
                        </entry>
                        <entry><constant>Zend_Date::YEAR_SHORT_8601</constant></entry>
                        <entry><emphasis>09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>YYY</constant></entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601, at least three digit
                        </entry>
                        <entry><constant>Zend_Date::YEAR_8601</constant></entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>YYYY</constant></entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601, at least four digit
                        </entry>
                        <entry><constant>Zend_Date::YEAR_8601</constant></entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>YYYYY</constant></entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601, at least five digit
                        </entry>
                        <entry><constant>Zend_Date::YEAR_8601</constant></entry>
                        <entry><emphasis>02009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>M</entry>
                        <entry>Month, one or two digit</entry>
                        <entry><constant>Zend_Date::MONTH_SHORT</constant></entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>MM</entry>
                        <entry>Month, two digit</entry>
                        <entry><constant>Zend_Date::MONTH</constant></entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>MMM</constant></entry>
                        <entry>Month, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::MONTH_NAME_SHORT</constant></entry>
                        <entry><emphasis>Feb</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>MMMM</constant></entry>
                        <entry>Month, localized, complete</entry>
                        <entry><constant>Zend_Date::MONTH_NAME</constant></entry>
                        <entry><emphasis>February</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>MMMMM</constant></entry>
                        <entry>Month, localized, abbreviated, one digit</entry>
                        <entry><constant>Zend_Date::MONTH_NAME_NARROW</constant></entry>
                        <entry><emphasis>F</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>w</entry>
                        <entry>Week, one or two digit</entry>
                        <entry><constant>Zend_Date::WEEK</constant></entry>
                        <entry><emphasis>5</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ww</entry>
                        <entry>Week, two digit</entry>
                        <entry><constant>Zend_Date::WEEK</constant></entry>
                        <entry><emphasis>05</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>d</entry>
                        <entry>Day of the month, one or two digit</entry>
                        <entry><constant>Zend_Date::DAY_SHORT</constant></entry>
                        <entry><emphasis>9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>dd</entry>
                        <entry>Day of the month, two digit</entry>
                        <entry><constant>Zend_Date::DAY</constant></entry>
                        <entry><emphasis>09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>D</entry>
                        <entry>Day of the year, one, two or three digit</entry>
                        <entry><constant>Zend_Date::DAY_OF_YEAR</constant></entry>
                        <entry><emphasis>7</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>DD</entry>
                        <entry>Day of the year, two or three digit</entry>
                        <entry><constant>Zend_Date::DAY_OF_YEAR</constant></entry>
                        <entry><emphasis>07</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>DDD</constant></entry>
                        <entry>Day of the year, three digit</entry>
                        <entry><constant>Zend_Date::DAY_OF_YEAR</constant></entry>
                        <entry><emphasis>007</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>E</entry>
                        <entry>Day of the week, localized, abbreviated, one char</entry>
                        <entry><constant>Zend_Date::WEEKDAY_NARROW</constant></entry>
                        <entry><emphasis>M</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>EE</entry>
                        <entry>Day of the week, localized, abbreviated, two or more chars</entry>
                        <entry><constant>Zend_Date::WEEKDAY_NAME</constant></entry>
                        <entry><emphasis>Mo</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>EEE</constant></entry>
                        <entry>Day of the week, localized, abbreviated, three chars</entry>
                        <entry><constant>Zend_Date::WEEKDAY_SHORT</constant></entry>
                        <entry><emphasis>Mon</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>EEEE</constant></entry>
                        <entry>Day of the week, localized, complete</entry>
                        <entry><constant>Zend_Date::WEEKDAY</constant></entry>
                        <entry><emphasis>Monday</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>EEEEE</constant></entry>
                        <entry>Day of the week, localized, abbreviated, one digit</entry>
                        <entry><constant>Zend_Date::WEEKDAY_NARROW</constant></entry>
                        <entry><emphasis>M</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>e</entry>
                        <entry>Number of the day, one digit</entry>
                        <entry><constant>Zend_Date::WEEKDAY_DIGIT</constant></entry>
                        <entry><emphasis>4</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ee</entry>
                        <entry>Number of the day, two digit</entry>
                        <entry><constant>Zend_Date::WEEKDAY_NARROW</constant></entry>
                        <entry><emphasis>04</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>a</entry>
                        <entry>Time of day, localized</entry>
                        <entry><constant>Zend_Date::MERIDIEM</constant></entry>
                        <entry><emphasis>vorm.</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>h</entry>
                        <entry>Hour, (1-12), one or two digit</entry>
                        <entry><constant>Zend_Date::HOUR_SHORT_AM</constant></entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>hh</entry>
                        <entry>Hour, (01-12), two digit</entry>
                        <entry><constant>Zend_Date::HOUR_AM</constant></entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>H</entry>
                        <entry>Hour, (0-23), one or two digit</entry>
                        <entry><constant>Zend_Date::HOUR_SHORT</constant></entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>HH</entry>
                        <entry>Hour, (00-23), two digit</entry>
                        <entry><constant>Zend_Date::HOUR</constant></entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>m</entry>
                        <entry>Minute, (0-59), one or two digit</entry>
                        <entry><constant>Zend_Date::MINUTE_SHORT</constant></entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>mm</entry>
                        <entry>Minute, (00-59), two digit</entry>
                        <entry><constant>Zend_Date::MINUTE</constant></entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>s</entry>
                        <entry>Second, (0-59), one or two digit</entry>
                        <entry><constant>Zend_Date::SECOND_SHORT</constant></entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ss</entry>
                        <entry>Second, (00-59), two digit</entry>
                        <entry><constant>Zend_Date::SECOND</constant></entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>S</entry>
                        <entry>Millisecond</entry>
                        <entry><constant>Zend_Date::MILLISECOND</constant></entry>
                        <entry><emphasis>20536</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>z</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::TIMEZONE</constant></entry>
                        <entry><emphasis><constant>CET</constant></emphasis></entry>
                    </row>
                    <row>
                        <entry>zz</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::TIMEZONE</constant></entry>
                        <entry><emphasis><constant>CET</constant></emphasis></entry>
                    </row>
                    <row>
                        <entry>zzz</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::TIMEZONE</constant></entry>
                        <entry><emphasis><constant>CET</constant></emphasis></entry>
                    </row>
                    <row>
                        <entry>zzzz</entry>
                        <entry>Time zone, localized, complete</entry>
                        <entry><constant>Zend_Date::TIMEZONE_NAME</constant></entry>
                        <entry><emphasis><command>Europe/Paris</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Z</entry>
                        <entry>Difference of time zone</entry>
                        <entry><constant>Zend_Date::GMT_DIFF</constant></entry>
                        <entry><emphasis>+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ZZ</entry>
                        <entry>Difference of time zone</entry>
                        <entry><constant>Zend_Date::GMT_DIFF</constant></entry>
                        <entry><emphasis>+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>ZZZ</constant></entry>
                        <entry>Difference of time zone</entry>
                        <entry><constant>Zend_Date::GMT_DIFF</constant></entry>
                        <entry><emphasis>+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry><constant>ZZZZ</constant></entry>
                        <entry>Difference of time zone, separated</entry>
                        <entry><constant>Zend_Date::GMT_DIFF_SEP</constant></entry>
                        <entry><emphasis>+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>A</entry>
                        <entry>Millisecond</entry>
                        <entry><constant>Zend_Date::MILLISECOND</constant></entry>
                        <entry><emphasis>20563</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <note>
            <para>
                Note that the default <acronym>ISO</acronym> format differs from
                <acronym>PHP</acronym>'s format which can be irritating if you have not used in
                previous. Especially the format specifiers for <emphasis>Year and Minute</emphasis>
                are often not used in the intended way.
            </para>

            <para>
                For <emphasis>year</emphasis> there are two specifiers available
                which are often mistaken. The <emphasis>Y</emphasis> specifier
                for the <acronym>ISO</acronym> year and the <emphasis>y</emphasis> specifier for the
                real year. The difference is small but significant.
                <emphasis>Y</emphasis> calculates the <acronym>ISO</acronym> year, which is often
                used for calendar formats. See for example the 31. December 2007. The real year is
                2007, but it is the first day of the first week in the week 1 of the year 2008.
                So, if you are using '<command>dd.MM.yyyy</command>' you will get
                '<command>31.December.2007</command>' but if you use '<command>dd.MM.YYYY</command>'
                you will get '<command>31.December.2008</command>'. As you see this is no bug but a
                expected behaviour depending on the used specifiers.
            </para>

            <para>
                For <emphasis>minute</emphasis> the difference is not so big. <acronym>ISO</acronym>
                uses the specifier <emphasis>m</emphasis> for the minute, unlike
                <acronym>PHP</acronym> which uses <emphasis>i</emphasis>. So if you are getting no
                minute in your format check if you have used the right specifier.
            </para>
        </note>
    </sect2>

    <sect2 id="zend.date.constants.phpformats">

        <title>Self-Defined OUTPUT Formats Using PHP's date() Format Specifiers</title>

        <para>
            If you are more comfortable with <acronym>PHP</acronym>'s date format specifier than
            with <acronym>ISO</acronym> format specifiers, then you can use the
            <methodname>Zend_Date::setOptions(array('format_type' => 'php'))</methodname> method to
            switch <classname>Zend_Date</classname> methods from supporting <acronym>ISO</acronym>
            format specifiers to <acronym>PHP</acronym> <methodname>date()</methodname> type
            specifiers. Afterwards, all format parameters must be given with <ulink
                url="http://php.net/date">PHP's <methodname>date()</methodname> format
                specifiers</ulink>. The <acronym>PHP</acronym> date format lacks some of the formats
            supported by the <acronym>ISO</acronym> Format, and vice-versa. If you are not already
            comfortable with it, then use the standard <acronym>ISO</acronym> format instead. Also,
            if you have legacy code using <acronym>PHP</acronym>'s date format, then either manually
            convert it to the <acronym>ISO</acronym> format using <link
                linkend="zend.locale.date.normalize">Zend_Locale_Format::convertPhpToIsoFormat()</link>,
            or use <methodname>setOptions()</methodname>. The following examples illustrate the
            usage of constants from the table below to create self-defined formats.
        </para>

        <example id="zend.date.constants.phpformats.example-1">
            <title>Self-Defined Formats with PHP Specifier</title>
            <programlisting language="php"><![CDATA[
$locale = new Zend_Locale('de_AT');
Zend_Date::setOptions(array('format_type' => 'php'));
$date = new Zend_Date(1234567890, false, $locale);

// outputs something like 'February 16, 2007, 3:36 am'
print $date->toString('F j, Y, g:i a');

print $date->toString("'Format:D M j G:i:s T Y='D M j G:i:s T Y");
]]></programlisting>
        </example>

        <para>
            The following table shows the list of <acronym>PHP</acronym> date format specifiers with
            their equivalent <classname>Zend_Date</classname> constants and
            <acronym>CLDR</acronym> and <acronym>ISO</acronym> equivalent format specifiers. In most
            cases, when the <acronym>CLDR</acronym> and <acronym>ISO</acronym> format does not have
            an equivalent format specifier, the <acronym>PHP</acronym> format specifier is not
            altered by <methodname>Zend_Locale_Format::convertPhpToIsoFormat()</methodname>, and the
            <classname>Zend_Date</classname> methods then recognize these "peculiar"
            <acronym>PHP</acronym> format specifiers, even when in the default
            "<acronym>ISO</acronym>" format mode.
        </para>

        <table id="zend.date.constants.phpformats.table">
            <title>Constants for PHP Date Output</title>
            <tgroup cols="5">
                <thead>
                    <row>
                        <entry>Constant</entry>
                        <entry>Description</entry>
                        <entry>Corresponds best to</entry>
                        <entry>closest <acronym>CLDR</acronym> equivalent</entry>
                        <entry>Result</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>d</entry>
                        <entry>Day of the month, two digit</entry>
                        <entry><constant>Zend_Date::DAY</constant></entry>
                        <entry>dd</entry>
                        <entry><emphasis>09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>D</entry>
                        <entry>Day of the week, localized, abbreviated, three digit</entry>
                        <entry><constant>Zend_Date::WEEKDAY_SHORT</constant></entry>
                        <entry><constant>EEE</constant></entry>
                        <entry><emphasis>Mon</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>j</entry>
                        <entry>Day of the month, one or two digit</entry>
                        <entry><constant>Zend_Date::DAY_SHORT</constant></entry>
                        <entry>d</entry>
                        <entry><emphasis>9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>l (lowercase L)</entry>
                        <entry>Day of the week, localized, complete</entry>
                        <entry><constant>Zend_Date::WEEKDAY</constant></entry>
                        <entry><constant>EEEE</constant></entry>
                        <entry><emphasis>Monday</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>N</entry>
                        <entry>Number of the weekday, one digit</entry>
                        <entry><constant>Zend_Date::WEEKDAY_8601</constant></entry>
                        <entry>e</entry>
                        <entry><emphasis>4</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>S</entry>
                        <entry>English suffixes for day of month, two chars</entry>
                        <entry>no equivalent</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>st</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>w</entry>
                        <entry>Number of the weekday, 0=sunday, 6=saturday</entry>
                        <entry><constant>Zend_Date::WEEKDAY_DIGIT</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>4</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>z</entry>
                        <entry>Day of the year, one, two or three digit</entry>
                        <entry><constant>Zend_Date::DAY_OF_YEAR</constant></entry>
                        <entry>D</entry>
                        <entry><emphasis>7</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>W</entry>
                        <entry>Week, one or two digit</entry>
                        <entry><constant>Zend_Date::WEEK</constant></entry>
                        <entry>w</entry>
                        <entry><emphasis>5</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>F</entry>
                        <entry>Month, localized, complete</entry>
                        <entry><constant>Zend_Date::MONTH_NAME</constant></entry>
                        <entry><constant>MMMM</constant></entry>
                        <entry><emphasis>February</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>m</entry>
                        <entry>Month, two digit</entry>
                        <entry><constant>Zend_Date::MONTH</constant></entry>
                        <entry>MM</entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>M</entry>
                        <entry>Month, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::MONTH_NAME_SHORT</constant></entry>
                        <entry><constant>MMM</constant></entry>
                        <entry><emphasis>Feb</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>n</entry>
                        <entry>Month, one or two digit</entry>
                        <entry><constant>Zend_Date::MONTH_SHORT</constant></entry>
                        <entry>M</entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>t</entry>
                        <entry>Number of days per month, one or two digits</entry>
                        <entry><constant>Zend_Date::MONTH_DAYS</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>30</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>L</entry>
                        <entry>Leapyear, boolean</entry>
                        <entry><constant>Zend_Date::LEAPYEAR</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>true</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>o</entry>
                        <entry>
                            Year according to <acronym>ISO</acronym> 8601, at least four digit
                        </entry>
                        <entry><constant>Zend_Date::YEAR_8601</constant></entry>
                        <entry><constant>YYYY</constant></entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Y</entry>
                        <entry>Year, at least four digit</entry>
                        <entry><constant>Zend_Date::YEAR</constant></entry>
                        <entry>yyyy</entry>
                        <entry><emphasis>2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>y</entry>
                        <entry>Year, at least two digit</entry>
                        <entry><constant>Zend_Date::YEAR_SHORT</constant></entry>
                        <entry>yy</entry>
                        <entry><emphasis>09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>a</entry>
                        <entry>Time of day, localized</entry>
                        <entry><constant>Zend_Date::MERIDIEM</constant></entry>
                        <entry>a (sort of, but likely to be uppercase)</entry>
                        <entry><emphasis>vorm.</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>A</entry>
                        <entry>Time of day, localized</entry>
                        <entry><constant>Zend_Date::MERIDIEM</constant></entry>
                        <entry>a (sort of, but no guarantee that the format is uppercase)</entry>
                        <entry><emphasis><command>VORM.</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>B</entry>
                        <entry>Swatch internet time</entry>
                        <entry><constant>Zend_Date::SWATCH</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>1463</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>g</entry>
                        <entry>Hour, (1-12), one or two digit</entry>
                        <entry><constant>Zend_Date::HOUR_SHORT_AM</constant></entry>
                        <entry>h</entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>G</entry>
                        <entry>Hour, (0-23), one or two digit</entry>
                        <entry><constant>Zend_Date::HOUR_SHORT</constant></entry>
                        <entry>H</entry>
                        <entry><emphasis>2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>h</entry>
                        <entry>Hour, (01-12), two digit</entry>
                        <entry><constant>Zend_Date::HOUR_AM</constant></entry>
                        <entry>hh</entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>H</entry>
                        <entry>Hour, (00-23), two digit</entry>
                        <entry><constant>Zend_Date::HOUR</constant></entry>
                        <entry>HH</entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>i</entry>
                        <entry>Minute, (00-59), two digit</entry>
                        <entry><constant>Zend_Date::MINUTE</constant></entry>
                        <entry>mm</entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>s</entry>
                        <entry>Second, (00-59), two digit</entry>
                        <entry><constant>Zend_Date::SECOND</constant></entry>
                        <entry>ss</entry>
                        <entry><emphasis>02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>e</entry>
                        <entry>Time zone, localized, complete</entry>
                        <entry><constant>Zend_Date::TIMEZONE_NAME</constant></entry>
                        <entry>zzzz</entry>
                        <entry><emphasis><command>Europe/Paris</command></emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>I</entry>
                        <entry>Daylight</entry>
                        <entry><constant>Zend_Date::DAYLIGHT</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>1</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>O</entry>
                        <entry>Difference of time zone</entry>
                        <entry><constant>Zend_Date::GMT_DIFF</constant></entry>
                        <entry>Z or ZZ or <constant>ZZZ</constant></entry>
                        <entry><emphasis>+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>P</entry>
                        <entry>Difference of time zone, separated</entry>
                        <entry><constant>Zend_Date::GMT_DIFF_SEP</constant></entry>
                        <entry><constant>ZZZZ</constant></entry>
                        <entry><emphasis>+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>T</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry><constant>Zend_Date::TIMEZONE</constant></entry>
                        <entry>z or zz or zzz</entry>
                        <entry><emphasis><constant>CET</constant></emphasis></entry>
                    </row>
                    <row>
                        <entry>Z</entry>
                        <entry>Time zone offset in seconds</entry>
                        <entry><constant>Zend_Date::TIMEZONE_SECS</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>3600</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>c</entry>
                        <entry>Standard Iso format output</entry>
                        <entry><constant>Zend_Date::ISO_8601</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>2004-02-12T15:19:21+00:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>r</entry>
                        <entry>Standard Rfc 2822 format output</entry>
                        <entry><constant>Zend_Date::RFC_2822</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>Thu, 21 Dec 2000 16:01:07 +0200</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>U</entry>
                        <entry>Unix timestamp</entry>
                        <entry><constant>Zend_Date::TIMESTAMP</constant></entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis>15275422364</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

    </sect2>

</sect1>