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 <code>$parts</code> 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. RFC 822).
    </para>

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

        <title>Using Constants</title>

        <para>
            For example, the constant <classname>Zend_Date::HOUR</classname> 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 GMT/UTC 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>Function/input</entry>
                        <entry>Description</entry>
                        <entry>Original date</entry>
                        <entry>Effect/output</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>get(Zend_Date::HOUR)</entry>
                        <entry>Output of the hour</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>14</entry>
                    </row>
                    <row>
                        <entry>set(12, Zend_Date::HOUR)</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>add(12, Zend_Date::HOUR)</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>sub(12, Zend_Date::HOUR)</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>compare(12, Zend_Date::HOUR)</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>copy(Zend_Date::HOUR)</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>equals(14, Zend_Date::HOUR)</entry>
                        <entry>Compares the hour, returns TRUE or FALSE</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>TRUE</entry>
                    </row>
                    <row>
                        <entry>isEarlier(12, Zend_Date::HOUR)</entry>
                        <entry>Compares the hour, returns TRUE or FALSE</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>TRUE</entry>
                    </row>
                    <row>
                        <entry>isLater(12, Zend_Date::HOUR)</entry>
                        <entry>Compares the hour, returns TRUE or FALSE</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry>FALSE</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

    </sect2>

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

        <title>List of All Constants</title>

        <para>
            Each part of a date/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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::DAY</entry>
                        <entry>Day (as a number, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-02-<emphasis role="strong">06</emphasis>T14:53:27+01:00 (06)</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DAY_SHORT</entry>
                        <entry>Day (as a number, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-02-0<emphasis role="strong">6</emphasis>T14:53:27+01:00 (6)</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::WEEKDAY</entry>
                        <entry>Weekday (Name of the day, localized, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Friday</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::WEEKDAY_SHORT</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 role="strong">Fri</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::WEEKDAY_NAME</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 role="strong">Fr</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::WEEKDAY_NARROW</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 role="strong">F</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::WEEKDAY_DIGIT</entry>
                        <entry>Weekday (0 = Sunday, 6 = Saturday)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">5</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::WEEKDAY_8601</entry>
                        <entry>Weekday according to ISO 8601 (1 = Monday, 7 = Sunday)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">5</emphasis> for Friday</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DAY_OF_YEAR</entry>
                        <entry>Day (as a number, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">43</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DAY_SUFFIX</entry>
                        <entry>English addendum for the day (st, nd, rd, th)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::WEEK</entry>
                        <entry>Week (as a number, 1-53)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::MONTH_NAME</entry>
                        <entry>Month (Name of the month, localized, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">February</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MONTH_NAME_SHORT</entry>
                        <entry>Month (Name of the month, localized, abbreviated, three digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Feb</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MONTH_NAME_NARROW</entry>
                        <entry>Month (Name of the month, localized, abbreviated, one digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">F</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MONTH</entry>
                        <entry>Month (Number of the month, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-<emphasis role="strong">02</emphasis>-06T14:53:27+01:00 (02)</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MONTH_SHORT</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 role="strong">2</emphasis>-06T14:53:27+01:00 (2)</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MONTH_DAYS</entry>
                        <entry>Number of days for this month (number)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::YEAR</entry>
                        <entry>Year (number)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">2009</emphasis>-02-06T14:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::YEAR_8601</entry>
                        <entry>Year according to ISO 8601 (number)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::YEAR_SHORT</entry>
                        <entry>Year (number, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>20<emphasis role="strong">09</emphasis>-02-06T14:53:27+01:00</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::YEAR_SHORT_8601</entry>
                        <entry>Year according to ISO 8601 (number, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::LEAPYEAR</entry>
                        <entry>Is the year a leap year? (TRUE or FALSE)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">FALSE</emphasis>
                        </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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::HOUR</entry>
                        <entry>Hour (00-23, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">14</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::HOUR_SHORT</entry>
                        <entry>Hour (0-23, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">14</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::HOUR_SHORT_AM</entry>
                        <entry>Hour (1-12, one or two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::HOUR_AM</entry>
                        <entry>Hour (01-12, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MINUTE</entry>
                        <entry>Minute (00-59, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-02-06T14:<emphasis role="strong">53</emphasis>:27+01:00</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MINUTE_SHORT</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 role="strong">3</emphasis>:27+01:00</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::SECOND</entry>
                        <entry>Second (00-59, two digit)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry>2009-02-06T14:53:<emphasis role="strong">27</emphasis>+01:00</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::SECOND_SHORT</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 role="strong">7</emphasis>+01:00</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MILLISECOND</entry>
                        <entry>Millisecond (theoretically infinite)</entry>
                        <entry>2009-02-06T14:53:27.20546</entry>
                        <entry>2009-02-06T14:53:27.<emphasis role="strong">20546</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::MERIDIEM</entry>
                        <entry>Time of day (forenoon/afternoon)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">afternoon</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::SWATCH</entry>
                        <entry>Swatch Internet Time</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::TIMEZONE</entry>
                        <entry>Name der time zone (string, abbreviated)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIMEZONE_NAME</entry>
                        <entry>Name of the time zone (string, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Europe/Paris</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIMEZONE_SECS</entry>
                        <entry>Difference of the time zone to GMT in seconds (integer)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">3600</emphasis> seconds to GMT</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::GMT_DIFF</entry>
                        <entry>Difference to GMT in seconds (string)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::GMT_DIFF_SEP</entry>
                        <entry>Difference to GMT in seconds (string, separated)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DAYLIGHT</entry>
                        <entry>Summer time or Winter time? (TRUE or FALSE)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">FALSE</emphasis>
                        </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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::ISO_8601</entry>
                        <entry>Date according to ISO 8601 (string, complete)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">2009-02-13T14:53:27+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::RFC_2822</entry>
                        <entry>Date according to RFC 2822 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIMESTAMP</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 role="strong">1234533207</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::ATOM</entry>
                        <entry>Date according to ATOM (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">2009-02-13T14:53:27+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::COOKIE</entry>
                        <entry>Date for Cookies (string, for Cookies)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Friday, 13-Feb-09 14:53:27 Europe/Paris</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::RFC_822</entry>
                        <entry>Date according to RFC 822 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Fri, 13 Feb 09 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::RFC_850</entry>
                        <entry>Date according to RFC 850 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Friday, 13-Feb-09 14:53:27 Europe/Paris</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::RFC_1036</entry>
                        <entry>Date according to RFC 1036 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Fri, 13 Feb 09 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::RFC_1123</entry>
                        <entry>Date according to RFC 1123 (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::RSS</entry>
                        <entry>Date for RSS Feeds (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::W3C</entry>
                        <entry>Date for HTML/HTTP according to W3C (string)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">2009-02-13T14:53:27+01:00</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

        <para>
            Especially note <classname>Zend_Date::DATES</classname>, since this format specifier has a unique property within
            <classname>Zend_Date</classname> as an <emphasis role="strong">input</emphasis> format specifier. When used as an
            input format for <code>$part</code>, 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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>Zend_Date::ERA</entry>
                        <entry>Epoch (string, localized, abbreviated)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">AD</emphasis> (anno Domini)</entry>
                    </row>
                    <row>
                        <entry>Zend_Date::ERA_NAME</entry>
                        <entry>Epoch (string, localized, complete)</entry>
                        <entry>2009-02-06T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">anno domini</emphasis> (anno Domini)</entry>
                    </row>
                    <row>
                        <entry><emphasis role="strong">Zend_Date::DATES</emphasis>
                        </entry>
                        <entry>Standard date (string, localized, default value).</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">13.02.2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DATE_FULL</entry>
                        <entry>Complete date (string, localized, complete)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">Friday, 13. February 2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DATE_LONG</entry>
                        <entry>Long date (string, localized, long)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">13. February 2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DATE_MEDIUM</entry>
                        <entry>Normal date (string, localized, normal)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">13.02.2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::DATE_SHORT</entry>
                        <entry>Abbreviated Date (string, localized, abbreviated)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">13.02.09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIMES</entry>
                        <entry>Standard time (string, localized, default value)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">14:53:27</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIME_FULL</entry>
                        <entry>Complete time (string, localized, complete)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">14:53 Uhr CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIME_LONG</entry>
                        <entry>Long time (string, localized, Long)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">14:53:27 CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIME_MEDIUM</entry>
                        <entry>Normal time (string, localized, normal)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">14:53:27</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Zend_Date::TIME_SHORT</entry>
                        <entry>Abbreviated time (string, localized, abbreviated)</entry>
                        <entry>2009-02-13T14:53:27+01:00</entry>
                        <entry><emphasis role="strong">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 ISO format token
            specifiers below. The following examples illustrate the usage of constants from the table below to create
            self-defined ISO formats. The format length is unlimited. Also, multiple usage of format constants is
            allowed.
        </para>

        <para>
            The accepted format specifiers can be changed from ISO Format to PHP's date format if you are more
            comfortable with it. However, not all formats defined in the ISO norm are supported with PHP's date format
            specifiers. Use the <classname>Zend_Date::setOptions(array('format_type' => 'php'))</classname> method to switch
            Zend_Date methods from supporting ISO format specifiers to PHP date() 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 role="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>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>G</entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry>Zend_Date::ERA</entry>
                        <entry><emphasis role="strong">AD</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>GG</entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry>Zend_Date::ERA</entry>
                        <entry><emphasis role="strong">AD</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>GGG</entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry>Zend_Date::ERA</entry>
                        <entry><emphasis role="strong">AD</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>GGGG</entry>
                        <entry>Epoch, localized, complete</entry>
                        <entry>Zend_Date::ERA_NAME</entry>
                        <entry><emphasis role="strong">anno domini</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>GGGGG</entry>
                        <entry>Epoch, localized, abbreviated</entry>
                        <entry>Zend_Date::ERA</entry>
                        <entry><emphasis role="strong">a</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>y</entry>
                        <entry>Year, at least one digit</entry>
                        <entry>Zend_Date::YEAR</entry>
                        <entry><emphasis role="strong">9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yy</entry>
                        <entry>Year, at least two digit</entry>
                        <entry>Zend_Date::YEAR_SHORT</entry>
                        <entry><emphasis role="strong">09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yyy</entry>
                        <entry>Year, at least three digit</entry>
                        <entry>Zend_Date::YEAR</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yyyy</entry>
                        <entry>Year, at least four digit</entry>
                        <entry>Zend_Date::YEAR</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>yyyyy</entry>
                        <entry>Year, at least five digit</entry>
                        <entry>Zend_Date::YEAR</entry>
                        <entry><emphasis role="strong">02009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Y</entry>
                        <entry>Year according to ISO 8601, at least one digit</entry>
                        <entry>Zend_Date::YEAR_8601</entry>
                        <entry><emphasis role="strong">9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>YY</entry>
                        <entry>Year according to ISO 8601, at least two digit</entry>
                        <entry>Zend_Date::YEAR_SHORT_8601</entry>
                        <entry><emphasis role="strong">09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>YYY</entry>
                        <entry>Year according to ISO 8601, at least three digit</entry>
                        <entry>Zend_Date::YEAR_8601</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>YYYY</entry>
                        <entry>Year according to ISO 8601, at least four digit</entry>
                        <entry>Zend_Date::YEAR_8601</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>YYYYY</entry>
                        <entry>Year according to ISO 8601, at least five digit</entry>
                        <entry>Zend_Date::YEAR_8601</entry>
                        <entry><emphasis role="strong">02009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>M</entry>
                        <entry>Month, one or two digit</entry>
                        <entry>Zend_Date::MONTH_SHORT</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>MM</entry>
                        <entry>Month, two digit</entry>
                        <entry>Zend_Date::MONTH</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>MMM</entry>
                        <entry>Month, localized, abbreviated</entry>
                        <entry>Zend_Date::MONTH_NAME_SHORT</entry>
                        <entry><emphasis role="strong">Feb</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>MMMM</entry>
                        <entry>Month, localized, complete</entry>
                        <entry>Zend_Date::MONTH_NAME</entry>
                        <entry><emphasis role="strong">February</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>MMMMM</entry>
                        <entry>Month, localized, abbreviated, one digit</entry>
                        <entry>Zend_Date::MONTH_NAME_NARROW</entry>
                        <entry><emphasis role="strong">F</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>w</entry>
                        <entry>Week, one or two digit</entry>
                        <entry>Zend_Date::WEEK</entry>
                        <entry><emphasis role="strong">5</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ww</entry>
                        <entry>Week, two digit</entry>
                        <entry>Zend_Date::WEEK</entry>
                        <entry><emphasis role="strong">05</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>d</entry>
                        <entry>Day of the month, one or two digit</entry>
                        <entry>Zend_Date::DAY_SHORT</entry>
                        <entry><emphasis role="strong">9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>dd</entry>
                        <entry>Day of the month, two digit</entry>
                        <entry>Zend_Date::DAY</entry>
                        <entry><emphasis role="strong">09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>D</entry>
                        <entry>Day of the year, one, two or three digit</entry>
                        <entry>Zend_Date::DAY_OF_YEAR</entry>
                        <entry><emphasis role="strong">7</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>DD</entry>
                        <entry>Day of the year, two or three digit</entry>
                        <entry>Zend_Date::DAY_OF_YEAR</entry>
                        <entry><emphasis role="strong">07</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>DDD</entry>
                        <entry>Day of the year, three digit</entry>
                        <entry>Zend_Date::DAY_OF_YEAR</entry>
                        <entry><emphasis role="strong">007</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>E</entry>
                        <entry>Day of the week, localized, abbreviated, one char</entry>
                        <entry>Zend_Date::WEEKDAY_NARROW</entry>
                        <entry><emphasis role="strong">M</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>EE</entry>
                        <entry>Day of the week, localized, abbreviated, two char</entry>
                        <entry>Zend_Date::WEEKDAY_NAME</entry>
                        <entry><emphasis role="strong">Mo</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>EEE</entry>
                        <entry>Day of the week, localized, abbreviated, three char</entry>
                        <entry>Zend_Date::WEEKDAY_SHORT</entry>
                        <entry><emphasis role="strong">Mon</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>EEEE</entry>
                        <entry>Day of the week, localized, complete</entry>
                        <entry>Zend_Date::WEEKDAY</entry>
                        <entry><emphasis role="strong">Monday</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>EEEEE</entry>
                        <entry>Day of the week, localized, abbreviated, one digit</entry>
                        <entry>Zend_Date::WEEKDAY_NARROW</entry>
                        <entry><emphasis role="strong">M</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>e</entry>
                        <entry>Number of the day, one digit</entry>
                        <entry>Zend_Date::WEEKDAY_NARROW</entry>
                        <entry><emphasis role="strong">4</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ee</entry>
                        <entry>Number of the day, two digit</entry>
                        <entry>Zend_Date::WEEKDAY_NARROW</entry>
                        <entry><emphasis role="strong">04</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>a</entry>
                        <entry>Time of day, localized</entry>
                        <entry>Zend_Date::MERIDIEM</entry>
                        <entry><emphasis role="strong">vorm.</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>h</entry>
                        <entry>Hour, (1-12), one or two digit</entry>
                        <entry>Zend_Date::HOUR_SHORT_AM</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>hh</entry>
                        <entry>Hour, (01-12), two digit</entry>
                        <entry>Zend_Date::HOUR_AM</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>H</entry>
                        <entry>Hour, (0-23), one or two digit</entry>
                        <entry>Zend_Date::HOUR_SHORT</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>HH</entry>
                        <entry>Hour, (00-23), two digit</entry>
                        <entry>Zend_Date::HOUR</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>m</entry>
                        <entry>Minute, (0-59), one or two digit</entry>
                        <entry>Zend_Date::MINUTE_SHORT</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>mm</entry>
                        <entry>Minute, (00-59), two digit</entry>
                        <entry>Zend_Date::MINUTE</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>s</entry>
                        <entry>Second, (0-59), one or two digit</entry>
                        <entry>Zend_Date::SECOND_SHORT</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ss</entry>
                        <entry>Second, (00-59), two digit</entry>
                        <entry>Zend_Date::SECOND</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>S</entry>
                        <entry>Millisecond</entry>
                        <entry>Zend_Date::MILLISECOND</entry>
                        <entry><emphasis role="strong">20536</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>z</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry>Zend_Date::TIMEZONE</entry>
                        <entry><emphasis role="strong">CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>zz</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry>Zend_Date::TIMEZONE</entry>
                        <entry><emphasis role="strong">CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>zzz</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry>Zend_Date::TIMEZONE</entry>
                        <entry><emphasis role="strong">CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>zzzz</entry>
                        <entry>Time zone, localized, complete</entry>
                        <entry>Zend_Date::TIMEZONE_NAME</entry>
                        <entry><emphasis role="strong">Europe/Paris</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Z</entry>
                        <entry>Difference of time zone</entry>
                        <entry>Zend_Date::GMT_DIFF</entry>
                        <entry><emphasis role="strong">+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ZZ</entry>
                        <entry>Difference of time zone</entry>
                        <entry>Zend_Date::GMT_DIFF</entry>
                        <entry><emphasis role="strong">+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ZZZ</entry>
                        <entry>Difference of time zone</entry>
                        <entry>Zend_Date::GMT_DIFF</entry>
                        <entry><emphasis role="strong">+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>ZZZZ</entry>
                        <entry>Difference of time zone, separated</entry>
                        <entry>Zend_Date::GMT_DIFF_SEP</entry>
                        <entry><emphasis role="strong">+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>A</entry>
                        <entry>Millisecond</entry>
                        <entry>Zend_Date::MILLISECOND</entry>
                        <entry><emphasis role="strong">20563</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

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

            <para>
                For <emphasis role="strong">year</emphasis> there are two specifiers available
                which are often mistaken. The <emphasis role="strong">Y</emphasis> specifier
                for the ISO year and the <emphasis role="strong">y</emphasis> specifier for the
                real year. The difference is small but significant.
                <emphasis role="strong">Y</emphasis> calculates the ISO 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 'dd.MM.yyyy' you will get '31.December.2007' but if you use
                'dd.MM.YYYY' you will get '31.December.2008'. As you see this is no bug but a
                expected behaviour depending on the used specifiers.
            </para>

            <para>
                For <emphasis role="strong">minute</emphasis> the difference is not so big. ISO
                uses the specifier <emphasis role="strong">m</emphasis> for the minute, unlike
                PHP which uses <emphasis role="strong">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 PHP's date format specifier than with ISO format specifiers, then you can
            use the <classname>Zend_Date::setOptions(array('format_type' => 'php'))</classname> method to switch Zend_Date methods from
            supporting ISO format specifiers to PHP date() type specifiers. Afterwards, all format parameters must be
            given with
            <ulink url="http://php.net/date">PHP's <code>date()</code> format specifiers</ulink>
            . The PHP date format lacks some of the formats supported by the ISO Format, and vice-versa. If you are not
            already comfortable with it, then use the standard ISO format instead. Also, if you have legacy code using
            PHP's date format, then either manually convert it to the ISO format using
            <link linkend="zend.locale.date.normalize">Zend_Locale_Format::convertPhpToIsoFormat()</link>
            , or use <code>setOptions()</code>. 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 role="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 PHP date format specifiers with their equivalent Zend_Date constants
            and CLDR/ISO equivalent format specifiers. In most cases, when the CLDR/ISO format does not have an
            equivalent format specifier, the PHP format specifier is not altered by
            <classname>Zend_Locale_Format::convertPhpToIsoFormat()</classname>, and the Zend_Date methods then recognize these
            "peculiar" PHP format specifiers, even when in the default "ISO" 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 CLDR equivalent</entry>
                        <entry>Affected part/example</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry>d</entry>
                        <entry>Day of the month, two digit</entry>
                        <entry>Zend_Date::DAY</entry>
                        <entry>dd</entry>
                        <entry><emphasis role="strong">09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>D</entry>
                        <entry>Day of the week, localized, abbreviated, three digit</entry>
                        <entry>Zend_Date::WEEKDAY_SHORT</entry>
                        <entry>EEE</entry>
                        <entry><emphasis role="strong">Mon</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>j</entry>
                        <entry>Day of the month, one or two digit</entry>
                        <entry>Zend_Date::DAY_SHORT</entry>
                        <entry>d</entry>
                        <entry><emphasis role="strong">9</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>l (lowercase L)</entry>
                        <entry>Day of the week, localized, complete</entry>
                        <entry>Zend_Date::WEEKDAY</entry>
                        <entry>EEEE</entry>
                        <entry><emphasis role="strong">Monday</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>N</entry>
                        <entry>Number of the weekday, one digit</entry>
                        <entry>Zend_Date::WEEKDAY_8601</entry>
                        <entry>e</entry>
                        <entry><emphasis role="strong">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 role="strong">st</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>w</entry>
                        <entry>Number of the weekday, 0=sunday, 6=saturday</entry>
                        <entry>Zend_Date::WEEKDAY_DIGIT</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">4</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>z</entry>
                        <entry>Day of the year, one, two or three digit</entry>
                        <entry>Zend_Date::DAY_OF_YEAR</entry>
                        <entry>D</entry>
                        <entry><emphasis role="strong">7</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>W</entry>
                        <entry>Week, one or two digit</entry>
                        <entry>Zend_Date::WEEK</entry>
                        <entry>w</entry>
                        <entry><emphasis role="strong">5</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>F</entry>
                        <entry>Month, localized, complete</entry>
                        <entry>Zend_Date::MONTH_NAME</entry>
                        <entry>MMMM</entry>
                        <entry><emphasis role="strong">February</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>m</entry>
                        <entry>Month, two digit</entry>
                        <entry>Zend_Date::MONTH</entry>
                        <entry>MM</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>M</entry>
                        <entry>Month, localized, abbreviated</entry>
                        <entry>Zend_Date::MONTH_NAME_SHORT</entry>
                        <entry>MMM</entry>
                        <entry><emphasis role="strong">Feb</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>n</entry>
                        <entry>Month, one or two digit</entry>
                        <entry>Zend_Date::MONTH_SHORT</entry>
                        <entry>M</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>t</entry>
                        <entry>Number of days per month, one or two digits</entry>
                        <entry>Zend_Date::MONTH_DAYS</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">30</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>L</entry>
                        <entry>Leapyear, boolean</entry>
                        <entry>Zend_Date::LEAPYEAR</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">true</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>o</entry>
                        <entry>Year according to ISO 8601, at least four digit</entry>
                        <entry>Zend_Date::YEAR_8601</entry>
                        <entry>YYYY</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Y</entry>
                        <entry>Year, at least four digit</entry>
                        <entry>Zend_Date::YEAR</entry>
                        <entry>yyyy</entry>
                        <entry><emphasis role="strong">2009</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>y</entry>
                        <entry>Year, at least two digit</entry>
                        <entry>Zend_Date::YEAR_SHORT</entry>
                        <entry>yy</entry>
                        <entry><emphasis role="strong">09</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>a</entry>
                        <entry>Time of day, localized</entry>
                        <entry>Zend_Date::MERIDIEM</entry>
                        <entry>a (sort of, but likely to be uppercase)</entry>
                        <entry><emphasis role="strong">vorm.</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>A</entry>
                        <entry>Time of day, localized</entry>
                        <entry>Zend_Date::MERIDIEM</entry>
                        <entry>a (sort of, but no guarantee that the format is uppercase)</entry>
                        <entry><emphasis role="strong">VORM.</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>B</entry>
                        <entry>Swatch internet time</entry>
                        <entry>Zend_Date::SWATCH</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">1463</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>g</entry>
                        <entry>Hour, (1-12), one or two digit</entry>
                        <entry>Zend_Date::HOUR_SHORT_AM</entry>
                        <entry>h</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>G</entry>
                        <entry>Hour, (0-23), one or two digit</entry>
                        <entry>Zend_Date::HOUR_SHORT</entry>
                        <entry>H</entry>
                        <entry><emphasis role="strong">2</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>h</entry>
                        <entry>Hour, (01-12), two digit</entry>
                        <entry>Zend_Date::HOUR_AM</entry>
                        <entry>hh</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>H</entry>
                        <entry>Hour, (00-23), two digit</entry>
                        <entry>Zend_Date::HOUR</entry>
                        <entry>HH</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>i</entry>
                        <entry>Minute, (00-59), two digit</entry>
                        <entry>Zend_Date::MINUTE</entry>
                        <entry>mm</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>s</entry>
                        <entry>Second, (00-59), two digit</entry>
                        <entry>Zend_Date::SECOND</entry>
                        <entry>ss</entry>
                        <entry><emphasis role="strong">02</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>e</entry>
                        <entry>Time zone, localized, complete</entry>
                        <entry>Zend_Date::TIMEZONE_NAME</entry>
                        <entry>zzzz</entry>
                        <entry><emphasis role="strong">Europe/Paris</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>I</entry>
                        <entry>Daylight</entry>
                        <entry>Zend_Date::DAYLIGHT</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">1</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>O</entry>
                        <entry>Difference of time zone</entry>
                        <entry>Zend_Date::GMT_DIFF</entry>
                        <entry>Z or ZZ or ZZZ</entry>
                        <entry><emphasis role="strong">+0100</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>P</entry>
                        <entry>Difference of time zone, separated</entry>
                        <entry>Zend_Date::GMT_DIFF_SEP</entry>
                        <entry>ZZZZ</entry>
                        <entry><emphasis role="strong">+01:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>T</entry>
                        <entry>Time zone, localized, abbreviated</entry>
                        <entry>Zend_Date::TIMEZONE</entry>
                        <entry>z or zz or zzz</entry>
                        <entry><emphasis role="strong">CET</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>Z</entry>
                        <entry>Time zone offset in seconds</entry>
                        <entry>Zend_Date::TIMEZONE_SECS</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">3600</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>c</entry>
                        <entry>Standard Iso format output</entry>
                        <entry>Zend_Date::ISO_8601</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">2004-02-12T15:19:21+00:00</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>r</entry>
                        <entry>Standard Rfc 2822 format output</entry>
                        <entry>Zend_Date::RFC_2822</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">Thu, 21 Dec 2000 16:01:07 +0200</emphasis>
                        </entry>
                    </row>
                    <row>
                        <entry>U</entry>
                        <entry>Unix timestamp</entry>
                        <entry>Zend_Date::TIMESTAMP</entry>
                        <entry>no equivalent</entry>
                        <entry><emphasis role="strong">15275422364</emphasis>
                        </entry>
                    </row>
                </tbody>
            </tgroup>
        </table>

    </sect2>

</sect1>