| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437 |
- <?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-13T14:53:27+01:00</entry>
- <entry><emphasis>13</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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14:53:27+01:00</entry>
- <entry><emphasis>8</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-13T14: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-13T14: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-13T14: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-13T14:53:27+01:00</entry>
- <entry><emphasis>02</emphasis></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-13T14:53:27+01:00</entry>
- <entry><emphasis>2</emphasis></entry>
- </row>
- <row>
- <entry><constant>Zend_Date::MONTH_DAYS</constant></entry>
- <entry>Number of days for this month (number)</entry>
- <entry>2009-02-13T14: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-13T14:53:27+01:00</entry>
- <entry><emphasis>2009</emphasis></entry>
- </row>
- <row>
- <entry><constant>Zend_Date::YEAR_8601</constant></entry>
- <entry>Year according to <acronym>ISO</acronym> 8601 (number)</entry>
- <entry>2009-02-13T14: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-13T14:53:27+01:00</entry>
- <entry><emphasis>09</emphasis></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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14:53:27+01:00</entry>
- <entry><emphasis>53</emphasis></entry>
- </row>
- <row>
- <entry><constant>Zend_Date::MINUTE_SHORT</constant></entry>
- <entry>Minute (0-59, one or two digit)</entry>
- <entry>2009-02-13T14:03:27+01:00</entry>
- <entry><emphasis>3</emphasis></entry>
- </row>
- <row>
- <entry><constant>Zend_Date::SECOND</constant></entry>
- <entry>Second (00-59, two digit)</entry>
- <entry>2009-02-13T14:53:27+01:00</entry>
- <entry><emphasis>27</emphasis></entry>
- </row>
- <row>
- <entry><constant>Zend_Date::SECOND_SHORT</constant></entry>
- <entry>Second (0-59, one or two digit)</entry>
- <entry>2009-02-13T14:53:07+01:00</entry>
- <entry><emphasis>7</emphasis></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><emphasis>20546</emphasis></entry>
- </row>
- <row>
- <entry><constant>Zend_Date::MERIDIEM</constant></entry>
- <entry>Time of day (forenoon or afternoon)</entry>
- <entry>2009-02-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T14: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-13T15: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>
|