Zend_Date-Constants.xml 68 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428
  1. <sect1 id="zend.date.constants">
  2. <title> 一般日期函数的常量 </title>
  3. <para>
  4. 不论什么时候 <code>Zend_Date</code> 方法需要参数 <code>$parts</code>,下面常数中其中之一可担当此任,
  5. 用来选择日期的特定部分或指示日期使用的或期望使用的格式(例如 RFC 822)。
  6. </para>
  7. <sect2 id="zend.date.constants.using">
  8. <title> 使用常数 </title>
  9. <para>
  10. 例如,常数 <code>Zend_Date::HOUR</code> 可以像下列所示来使用。当和星期几、日期、小时、分钟、秒和任何其它因位于世界不同的地方而不同地表示的日期部分一起使用时,
  11. 对象的时区将自动用来计算当前值,即使是内部的时间戳和此刻一致并且不论用户的地理位置在世界的何方。
  12. 不管使用了哪些单元,输出必需表达为 GMT/UTC 或本地化。下面的输出例子反映了 Europe/GMT+1 hour (e.g. Germany, Austria, France) 的本地化。
  13. </para>
  14. <table id="zend.date.constants.using.table">
  15. <title> Zend_Date::HOUR 的操作 </title>
  16. <tgroup cols="4">
  17. <thead>
  18. <row>
  19. <entry> 函数/输入 </entry>
  20. <entry> 描述 </entry>
  21. <entry> 原始日期 </entry>
  22. <entry> 效果/输出 </entry>
  23. </row>
  24. </thead>
  25. <tbody>
  26. <row>
  27. <entry>get(Zend_Date::HOUR)</entry>
  28. <entry>Output of the hour</entry>
  29. <entry>2009-02-13T14:53:27+01:00</entry>
  30. <entry>14</entry>
  31. </row>
  32. <row>
  33. <entry>set(12, Zend_Date::HOUR)</entry>
  34. <entry>Set new hour</entry>
  35. <entry>2009-02-13T14:53:27+01:00</entry>
  36. <entry>2009-02-13T12:53:27+01:00</entry>
  37. </row>
  38. <row>
  39. <entry>add(12, Zend_Date::HOUR)</entry>
  40. <entry>Add hours</entry>
  41. <entry>2009-02-13T14:53:27+01:00</entry>
  42. <entry>2009-02-14T02:53:27+01:00</entry>
  43. </row>
  44. <row>
  45. <entry>sub(12, Zend_Date::HOUR)</entry>
  46. <entry>Subtract hours</entry>
  47. <entry>2009-02-13T14:53:27+01:00</entry>
  48. <entry>2009-02-13T02:53:27+01:00</entry>
  49. </row>
  50. <row>
  51. <entry>compare(12, Zend_Date::HOUR)</entry>
  52. <entry>Compare hour, returns 0, 1 or -1</entry>
  53. <entry>2009-02-13T14:53:27+01:00</entry>
  54. <entry>1 (if object > argument)</entry>
  55. </row>
  56. <row>
  57. <entry>copy(Zend_Date::HOUR)</entry>
  58. <entry>Copies only the hour part</entry>
  59. <entry>2009-02-13T14:53:27+01:00</entry>
  60. <entry>1970-01-01T14:00:00+01:00</entry>
  61. </row>
  62. <row>
  63. <entry>equals(14, Zend_Date::HOUR)</entry>
  64. <entry>Compares the hour, returns TRUE or FALSE</entry>
  65. <entry>2009-02-13T14:53:27+01:00</entry>
  66. <entry>TRUE</entry>
  67. </row>
  68. <row>
  69. <entry>isEarlier(12, Zend_Date::HOUR)</entry>
  70. <entry>Compares the hour, returns TRUE or FALSE</entry>
  71. <entry>2009-02-13T14:53:27+01:00</entry>
  72. <entry>TRUE</entry>
  73. </row>
  74. <row>
  75. <entry>isLater(12, Zend_Date::HOUR)</entry>
  76. <entry>Compares the hour, returns TRUE or FALSE</entry>
  77. <entry>2009-02-13T14:53:27+01:00</entry>
  78. <entry>FALSE</entry>
  79. </row>
  80. </tbody>
  81. </tgroup>
  82. </table>
  83. </sect2>
  84. <sect2 id="zend.date.constants.list">
  85. <title> 所有常数列表 </title>
  86. <para>
  87. 在 <code>Zend_Date</code> 中每个日期/时间的部分都有独一无二的常数。所有 <code>Zend_Date</code> 支持的常数如下:
  88. </para>
  89. <table id="zend.date.constants.list.table-1">
  90. <title>Day Constants</title>
  91. <tgroup cols="4">
  92. <thead>
  93. <row>
  94. <entry> 常数 </entry>
  95. <entry> 描述 </entry>
  96. <entry> 日期 </entry>
  97. <entry> 受影响部分/例子 </entry>
  98. </row>
  99. </thead>
  100. <tbody>
  101. <row>
  102. <entry>Zend_Date::DAY</entry>
  103. <entry>Day (as a number, two digit)</entry>
  104. <entry>2009-02-06T14:53:27+01:00</entry>
  105. <entry>2009-02-<emphasis role="strong">06</emphasis>T14:53:27+01:00 (06)</entry>
  106. </row>
  107. <row>
  108. <entry>Zend_Date::DAY_SHORT</entry>
  109. <entry>Day (as a number, one or two digit)</entry>
  110. <entry>2009-02-06T14:53:27+01:00</entry>
  111. <entry>2009-02-0<emphasis role="strong">6</emphasis>T14:53:27+01:00 (6)</entry>
  112. </row>
  113. <row>
  114. <entry>Zend_Date::WEEKDAY</entry>
  115. <entry>Weekday (Name of the day, localized, complete)</entry>
  116. <entry>2009-02-06T14:53:27+01:00</entry>
  117. <entry><emphasis role="strong">Friday</emphasis>
  118. </entry>
  119. </row>
  120. <row>
  121. <entry>Zend_Date::WEEKDAY_SHORT</entry>
  122. <entry>Weekday (Name of the day, localized, abbreviated, the first three digits)</entry>
  123. <entry>2009-02-06T14:53:27+01:00</entry>
  124. <entry><emphasis role="strong">Fre</emphasis> for Friday</entry>
  125. </row>
  126. <row>
  127. <entry>Zend_Date::WEEKDAY_NAME</entry>
  128. <entry>Weekday (Name of the day, localized, abbreviated, the first two digits)</entry>
  129. <entry>2009-02-06T14:53:27+01:00</entry>
  130. <entry><emphasis role="strong">Fr</emphasis> for Friday</entry>
  131. </row>
  132. <row>
  133. <entry>Zend_Date::WEEKDAY_NARROW</entry>
  134. <entry>Weekday (Name of the day, localized, abbreviated, only the first digit)</entry>
  135. <entry>2009-02-06T14:53:27+01:00</entry>
  136. <entry><emphasis role="strong">F</emphasis> for Friday</entry>
  137. </row>
  138. <row>
  139. <entry>Zend_Date::WEEKDAY_DIGIT</entry>
  140. <entry>Weekday (0 = Sunday, 6 = Saturday)</entry>
  141. <entry>2009-02-06T14:53:27+01:00</entry>
  142. <entry><emphasis role="strong">5</emphasis> for Friday</entry>
  143. </row>
  144. <row>
  145. <entry>Zend_Date::WEEKDAY_8601</entry>
  146. <entry>Weekday according to ISO 8601 (1 = Monday, 7 = Sunday)</entry>
  147. <entry>2009-02-06T14:53:27+01:00</entry>
  148. <entry><emphasis role="strong">5</emphasis> for Friday</entry>
  149. </row>
  150. <row>
  151. <entry>Zend_Date::DAY_OF_YEAR</entry>
  152. <entry>Day (as a number, one or two digit)</entry>
  153. <entry>2009-02-06T14:53:27+01:00</entry>
  154. <entry><emphasis role="strong">43</emphasis>
  155. </entry>
  156. </row>
  157. <row>
  158. <entry>Zend_Date::DAY_SUFFIX</entry>
  159. <entry>English addendum for the day (st, nd, rd, th)</entry>
  160. <entry>2009-02-06T14:53:27+01:00</entry>
  161. <entry><emphasis role="strong">th</emphasis>
  162. </entry>
  163. </row>
  164. </tbody>
  165. </tgroup>
  166. </table>
  167. <table id="zend.date.constants.list.table-2">
  168. <title> 星期常数 </title>
  169. <tgroup cols="4">
  170. <thead>
  171. <row>
  172. <entry> 常数 </entry>
  173. <entry> 描述 </entry>
  174. <entry> 日期 </entry>
  175. <entry> 受影响部分/例子 </entry>
  176. </row>
  177. </thead>
  178. <tbody>
  179. <row>
  180. <entry>Zend_Date::WEEK</entry>
  181. <entry>Week (as a number, 1-53)</entry>
  182. <entry>2009-02-06T14:53:27+01:00</entry>
  183. <entry><emphasis role="strong">7</emphasis>
  184. </entry>
  185. </row>
  186. </tbody>
  187. </tgroup>
  188. </table>
  189. <table id="zend.date.constants.list.table-3">
  190. <title> 月常数 </title>
  191. <tgroup cols="4">
  192. <thead>
  193. <row>
  194. <entry> 常数 </entry>
  195. <entry> 描述 </entry>
  196. <entry> 日期 </entry>
  197. <entry> 受影响部分/例子 </entry>
  198. </row>
  199. </thead>
  200. <tbody>
  201. <row>
  202. <entry>Zend_Date::MONTH_NAME</entry>
  203. <entry>Month (Name of the month, localized, complete)</entry>
  204. <entry>2009-02-06T14:53:27+01:00</entry>
  205. <entry><emphasis role="strong">February</emphasis>
  206. </entry>
  207. </row>
  208. <row>
  209. <entry>Zend_Date::MONTH_NAME_SHORT</entry>
  210. <entry>Month (Name of the month, localized, abbreviated, three digit)</entry>
  211. <entry>2009-02-06T14:53:27+01:00</entry>
  212. <entry><emphasis role="strong">Feb</emphasis>
  213. </entry>
  214. </row>
  215. <row>
  216. <entry>Zend_Date::MONTH_NAME_NARROW</entry>
  217. <entry>Month (Name of the month, localized, abbreviated, one digit)</entry>
  218. <entry>2009-02-06T14:53:27+01:00</entry>
  219. <entry><emphasis role="strong">F</emphasis>
  220. </entry>
  221. </row>
  222. <row>
  223. <entry>Zend_Date::MONTH</entry>
  224. <entry>Month (Number of the month, two digit)</entry>
  225. <entry>2009-02-06T14:53:27+01:00</entry>
  226. <entry>2009-<emphasis role="strong">02</emphasis>-06T14:53:27+01:00 (02)</entry>
  227. </row>
  228. <row>
  229. <entry>Zend_Date::MONTH_SHORT</entry>
  230. <entry>Month (Number of the month, one or two digit)</entry>
  231. <entry>2009-02-06T14:53:27+01:00</entry>
  232. <entry>2009-0<emphasis role="strong">2</emphasis>-06T14:53:27+01:00 (2)</entry>
  233. </row>
  234. <row>
  235. <entry>Zend_Date::MONTH_DAYS</entry>
  236. <entry>Number of days for this month (number)</entry>
  237. <entry>2009-02-06T14:53:27+01:00</entry>
  238. <entry><emphasis role="strong">28</emphasis>
  239. </entry>
  240. </row>
  241. </tbody>
  242. </tgroup>
  243. </table>
  244. <table id="zend.date.constants.list.table-4">
  245. <title> 年常数 </title>
  246. <tgroup cols="4">
  247. <thead>
  248. <row>
  249. <entry> 常数 </entry>
  250. <entry> 描述 </entry>
  251. <entry> 日期 </entry>
  252. <entry> 受影响部分/例子 </entry>
  253. </row>
  254. </thead>
  255. <tbody>
  256. <row>
  257. <entry>Zend_Date::YEAR</entry>
  258. <entry>Year (number)</entry>
  259. <entry>2009-02-06T14:53:27+01:00</entry>
  260. <entry><emphasis role="strong">2009</emphasis>-02-06T14:53:27+01:00</entry>
  261. </row>
  262. <row>
  263. <entry>Zend_Date::YEAR_8601</entry>
  264. <entry>Year according to ISO 8601 (number)</entry>
  265. <entry>2009-02-06T14:53:27+01:00</entry>
  266. <entry><emphasis role="strong">2009</emphasis>
  267. </entry>
  268. </row>
  269. <row>
  270. <entry>Zend_Date::YEAR_SHORT</entry>
  271. <entry>Year (number, two digit)</entry>
  272. <entry>2009-02-06T14:53:27+01:00</entry>
  273. <entry>20<emphasis role="strong">09</emphasis>-02-06T14:53:27+01:00</entry>
  274. </row>
  275. <row>
  276. <entry>Zend_Date::YEAR_SHORT_8601</entry>
  277. <entry>Year according to ISO 8601 (number, two digit)</entry>
  278. <entry>2009-02-06T14:53:27+01:00</entry>
  279. <entry><emphasis role="strong">09</emphasis>
  280. </entry>
  281. </row>
  282. <row>
  283. <entry>Zend_Date::LEAPYEAR</entry>
  284. <entry>Is the year a leap year? (TRUE or FALSE)</entry>
  285. <entry>2009-02-06T14:53:27+01:00</entry>
  286. <entry><emphasis role="strong">FALSE</emphasis>
  287. </entry>
  288. </row>
  289. </tbody>
  290. </tgroup>
  291. </table>
  292. <table id="zend.date.constants.list.table-5">
  293. <title> 时间常数 </title>
  294. <tgroup cols="4">
  295. <thead>
  296. <row>
  297. <entry> 常数 </entry>
  298. <entry> 描述 </entry>
  299. <entry> 日期 </entry>
  300. <entry> 受影响部分/例子 </entry>
  301. </row>
  302. </thead>
  303. <tbody>
  304. <row>
  305. <entry>Zend_Date::HOUR</entry>
  306. <entry>Hour (00-23, two digit)</entry>
  307. <entry>2009-02-06T14:53:27+01:00</entry>
  308. <entry><emphasis role="strong">14</emphasis>
  309. </entry>
  310. </row>
  311. <row>
  312. <entry>Zend_Date::HOUR_SHORT</entry>
  313. <entry>Hour (0-23, one or two digit)</entry>
  314. <entry>2009-02-06T14:53:27+01:00</entry>
  315. <entry><emphasis role="strong">14</emphasis>
  316. </entry>
  317. </row>
  318. <row>
  319. <entry>Zend_Date::HOUR_SHORT_AM</entry>
  320. <entry>Hour (1-12, one or two digit)</entry>
  321. <entry>2009-02-06T14:53:27+01:00</entry>
  322. <entry><emphasis role="strong">2</emphasis>
  323. </entry>
  324. </row>
  325. <row>
  326. <entry>Zend_Date::HOUR_AM</entry>
  327. <entry>Hour (01-12, two digit)</entry>
  328. <entry>2009-02-06T14:53:27+01:00</entry>
  329. <entry><emphasis role="strong">02</emphasis>
  330. </entry>
  331. </row>
  332. <row>
  333. <entry>Zend_Date::MINUTE</entry>
  334. <entry>Minute (00-59, two digit)</entry>
  335. <entry>2009-02-06T14:53:27+01:00</entry>
  336. <entry>2009-02-06T14:<emphasis role="strong">53</emphasis>:27+01:00</entry>
  337. </row>
  338. <row>
  339. <entry>Zend_Date::MINUTE_SHORT</entry>
  340. <entry>Minute (0-59, one or two digit)</entry>
  341. <entry>2009-02-06T14:03:27+01:00</entry>
  342. <entry>2009-02-06T14:0<emphasis role="strong">3</emphasis>:27+01:00</entry>
  343. </row>
  344. <row>
  345. <entry>Zend_Date::SECOND</entry>
  346. <entry>Second (00-59, two digit)</entry>
  347. <entry>2009-02-06T14:53:27+01:00</entry>
  348. <entry>2009-02-06T14:53:<emphasis role="strong">27</emphasis>+01:00</entry>
  349. </row>
  350. <row>
  351. <entry>Zend_Date::SECOND_SHORT</entry>
  352. <entry>Second (0-59, one or two digit)</entry>
  353. <entry>2009-02-06T14:53:07+01:00</entry>
  354. <entry>2009-02-06T14:53:0<emphasis role="strong">7</emphasis>+01:00</entry>
  355. </row>
  356. <row>
  357. <entry>Zend_Date::MILLISECOND</entry>
  358. <entry>Millisecond (theoretically infinite)</entry>
  359. <entry>2009-02-06T14:53:27.20546</entry>
  360. <entry>2009-02-06T14:53:27.<emphasis role="strong">20546</emphasis>
  361. </entry>
  362. </row>
  363. <row>
  364. <entry>Zend_Date::MERIDIEM</entry>
  365. <entry>Time of day (forenoon/afternoon)</entry>
  366. <entry>2009-02-06T14:53:27+01:00</entry>
  367. <entry><emphasis role="strong">afternoon</emphasis>
  368. </entry>
  369. </row>
  370. <row>
  371. <entry>Zend_Date::SWATCH</entry>
  372. <entry>Swatch Internet Time</entry>
  373. <entry>2009-02-06T14:53:27+01:00</entry>
  374. <entry><emphasis role="strong">620</emphasis>
  375. </entry>
  376. </row>
  377. </tbody>
  378. </tgroup>
  379. </table>
  380. <table id="zend.date.constants.list.table-6">
  381. <title> 时区常数 </title>
  382. <tgroup cols="4">
  383. <thead>
  384. <row>
  385. <entry> 常数 </entry>
  386. <entry> 描述 </entry>
  387. <entry> 日期 </entry>
  388. <entry> 受影响部分/例子 </entry>
  389. </row>
  390. </thead>
  391. <tbody>
  392. <row>
  393. <entry>Zend_Date::TIMEZONE</entry>
  394. <entry>Name der time zone (string, abbreviated)</entry>
  395. <entry>2009-02-06T14:53:27+01:00</entry>
  396. <entry><emphasis role="strong">CET</emphasis>
  397. </entry>
  398. </row>
  399. <row>
  400. <entry>Zend_Date::TIMEZONE_NAME</entry>
  401. <entry>Name of the time zone (string, complete)</entry>
  402. <entry>2009-02-06T14:53:27+01:00</entry>
  403. <entry><emphasis role="strong">Europe/Paris</emphasis>
  404. </entry>
  405. </row>
  406. <row>
  407. <entry>Zend_Date::TIMEZONE_SECS</entry>
  408. <entry>Difference of the time zone to GMT in seconds (integer)</entry>
  409. <entry>2009-02-06T14:53:27+01:00</entry>
  410. <entry><emphasis role="strong">3600</emphasis> seconds to GMT</entry>
  411. </row>
  412. <row>
  413. <entry>Zend_Date::GMT_DIFF</entry>
  414. <entry>Difference to GMT in seconds (string)</entry>
  415. <entry>2009-02-06T14:53:27+01:00</entry>
  416. <entry><emphasis role="strong">+0100</emphasis>
  417. </entry>
  418. </row>
  419. <row>
  420. <entry>Zend_Date::GMT_DIFF_SEP</entry>
  421. <entry>Difference to GMT in seconds (string, separated)</entry>
  422. <entry>2009-02-06T14:53:27+01:00</entry>
  423. <entry><emphasis role="strong">+01:00</emphasis>
  424. </entry>
  425. </row>
  426. <row>
  427. <entry>Zend_Date::DAYLIGHT</entry>
  428. <entry>Summer time or Winter time? (TRUE or FALSE)</entry>
  429. <entry>2009-02-06T14:53:27+01:00</entry>
  430. <entry><emphasis role="strong">FALSE</emphasis>
  431. </entry>
  432. </row>
  433. </tbody>
  434. </tgroup>
  435. </table>
  436. <table id="zend.date.constants.list.table-7">
  437. <title> 日期格式常数(格式包括时区)</title>
  438. <tgroup cols="4">
  439. <thead>
  440. <row>
  441. <entry> 常数 </entry>
  442. <entry> 描述 </entry>
  443. <entry> 日期 </entry>
  444. <entry> 受影响部分/例子 </entry>
  445. </row>
  446. </thead>
  447. <tbody>
  448. <row>
  449. <entry>Zend_Date::ISO_8601</entry>
  450. <entry>Date according to ISO 8601 (string, complete)</entry>
  451. <entry>2009-02-13T14:53:27+01:00</entry>
  452. <entry><emphasis role="strong">2009-02-13T14:53:27+01:00</emphasis>
  453. </entry>
  454. </row>
  455. <row>
  456. <entry>Zend_Date::RFC_2822</entry>
  457. <entry>Date according to RFC 2822 (string)</entry>
  458. <entry>2009-02-13T14:53:27+01:00</entry>
  459. <entry><emphasis role="strong">Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
  460. </entry>
  461. </row>
  462. <row>
  463. <entry>Zend_Date::TIMESTAMP</entry>
  464. <entry>
  465. <ulink url="http://en.wikipedia.org/wiki/Unix_Time">Unix time</ulink> (seconds since 1.1.1970, mixed)</entry>
  466. <entry>2009-02-13T14:53:27+01:00</entry>
  467. <entry><emphasis role="strong">1234533207</emphasis>
  468. </entry>
  469. </row>
  470. <row>
  471. <entry>Zend_Date::ATOM</entry>
  472. <entry>Date according to ATOM (string)</entry>
  473. <entry>2009-02-13T14:53:27+01:00</entry>
  474. <entry><emphasis role="strong">2009-02-13T14:53:27+01:00</emphasis>
  475. </entry>
  476. </row>
  477. <row>
  478. <entry>Zend_Date::COOKIE</entry>
  479. <entry>Date for Cookies (string, for Cookies)</entry>
  480. <entry>2009-02-13T14:53:27+01:00</entry>
  481. <entry><emphasis role="strong">Friday, 13-Feb-09 14:53:27 Europe/Paris</emphasis>
  482. </entry>
  483. </row>
  484. <row>
  485. <entry>Zend_Date::RFC_822</entry>
  486. <entry>Date according to RFC 822 (string)</entry>
  487. <entry>2009-02-13T14:53:27+01:00</entry>
  488. <entry><emphasis role="strong">Fri, 13 Feb 09 14:53:27 +0100</emphasis>
  489. </entry>
  490. </row>
  491. <row>
  492. <entry>Zend_Date::RFC_850</entry>
  493. <entry>Date according to RFC 850 (string)</entry>
  494. <entry>2009-02-13T14:53:27+01:00</entry>
  495. <entry><emphasis role="strong">Friday, 13-Feb-09 14:53:27 Europe/Paris</emphasis>
  496. </entry>
  497. </row>
  498. <row>
  499. <entry>Zend_Date::RFC_1036</entry>
  500. <entry>Date according to RFC 1036 (string)</entry>
  501. <entry>2009-02-13T14:53:27+01:00</entry>
  502. <entry><emphasis role="strong">Fri, 13 Feb 09 14:53:27 +0100</emphasis>
  503. </entry>
  504. </row>
  505. <row>
  506. <entry>Zend_Date::RFC_1123</entry>
  507. <entry>Date according to RFC 1123 (string)</entry>
  508. <entry>2009-02-13T14:53:27+01:00</entry>
  509. <entry><emphasis role="strong">Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
  510. </entry>
  511. </row>
  512. <row>
  513. <entry>Zend_Date::RSS</entry>
  514. <entry>Date for RSS Feeds (string)</entry>
  515. <entry>2009-02-13T14:53:27+01:00</entry>
  516. <entry><emphasis role="strong">Fri, 13 Feb 2009 14:53:27 +0100</emphasis>
  517. </entry>
  518. </row>
  519. <row>
  520. <entry>Zend_Date::W3C</entry>
  521. <entry>Date for HTML/HTTP according to W3C (string)</entry>
  522. <entry>2009-02-13T14:53:27+01:00</entry>
  523. <entry><emphasis role="strong">2009-02-13T14:53:27+01:00</emphasis>
  524. </entry>
  525. </row>
  526. </tbody>
  527. </tgroup>
  528. </table>
  529. <para>
  530. 特别注意 <code>Zend_Date::DATES</code>,因为这个格式指示器在 <code>Zend_Date</code> 之内有个唯一的属性作为 <emphasis role="strong"> 输入 </emphasis> 格式指示器。
  531. 当 <code>$part</code> 用作一个输入格式,该常量提灵活地接受许多相似的日期格式。启发式自动从输入字符串里解析并“修改”日期里的简单的错误(如果有的话),如当需要时,交换年月日的位置。
  532. </para>
  533. <table id="zend.date.constants.list.table-8">
  534. <title> 日期和时间格式 (format varies by locale)</title>
  535. <tgroup cols="4">
  536. <thead>
  537. <row>
  538. <entry> 常数 </entry>
  539. <entry> 描述 </entry>
  540. <entry> 日期 </entry>
  541. <entry> 受影响部分/例子 </entry>
  542. </row>
  543. </thead>
  544. <tbody>
  545. <row>
  546. <entry>Zend_Date::ERA</entry>
  547. <entry>Epoch (string, localized, abbreviated)</entry>
  548. <entry>2009-02-06T14:53:27+01:00</entry>
  549. <entry><emphasis role="strong">AD</emphasis> (anno Domini)</entry>
  550. </row>
  551. <row>
  552. <entry>Zend_Date::ERA_NAME</entry>
  553. <entry>Epoch (string, localized, complete)</entry>
  554. <entry>2009-02-06T14:53:27+01:00</entry>
  555. <entry><emphasis role="strong">anno domini</emphasis> (anno Domini)</entry>
  556. </row>
  557. <row>
  558. <entry><emphasis role="strong">Zend_Date::DATES</emphasis>
  559. </entry>
  560. <entry>Standard date (string, localized, default value).</entry>
  561. <entry>2009-02-13T14:53:27+01:00</entry>
  562. <entry><emphasis role="strong">13.02.2009</emphasis>
  563. </entry>
  564. </row>
  565. <row>
  566. <entry>Zend_Date::DATE_FULL</entry>
  567. <entry>Complete date (string, localized, complete)</entry>
  568. <entry>2009-02-13T14:53:27+01:00</entry>
  569. <entry><emphasis role="strong">Friday, 13. February 2009</emphasis>
  570. </entry>
  571. </row>
  572. <row>
  573. <entry>Zend_Date::DATE_LONG</entry>
  574. <entry>Long date (string, localized, long)</entry>
  575. <entry>2009-02-13T14:53:27+01:00</entry>
  576. <entry><emphasis role="strong">13. February 2009</emphasis>
  577. </entry>
  578. </row>
  579. <row>
  580. <entry>Zend_Date::DATE_MEDIUM</entry>
  581. <entry>Normal date (string, localized, normal)</entry>
  582. <entry>2009-02-13T14:53:27+01:00</entry>
  583. <entry><emphasis role="strong">13.02.2009</emphasis>
  584. </entry>
  585. </row>
  586. <row>
  587. <entry>Zend_Date::DATE_SHORT</entry>
  588. <entry>Abbreviated Date (string, localized, abbreviated)</entry>
  589. <entry>2009-02-13T14:53:27+01:00</entry>
  590. <entry><emphasis role="strong">13.02.09</emphasis>
  591. </entry>
  592. </row>
  593. <row>
  594. <entry>Zend_Date::TIMES</entry>
  595. <entry>Standard time (string, localized, default value)</entry>
  596. <entry>2009-02-13T14:53:27+01:00</entry>
  597. <entry><emphasis role="strong">14:53:27</emphasis>
  598. </entry>
  599. </row>
  600. <row>
  601. <entry>Zend_Date::TIME_FULL</entry>
  602. <entry>Complete time (string, localized, complete)</entry>
  603. <entry>2009-02-13T14:53:27+01:00</entry>
  604. <entry><emphasis role="strong">14:53 Uhr CET</emphasis>
  605. </entry>
  606. </row>
  607. <row>
  608. <entry>Zend_Date::TIME_LONG</entry>
  609. <entry>Long time (string, localized, Long)</entry>
  610. <entry>2009-02-13T14:53:27+01:00</entry>
  611. <entry><emphasis role="strong">14:53:27 CET</emphasis>
  612. </entry>
  613. </row>
  614. <row>
  615. <entry>Zend_Date::TIME_MEDIUM</entry>
  616. <entry>Normal time (string, localized, normal)</entry>
  617. <entry>2009-02-13T14:53:27+01:00</entry>
  618. <entry><emphasis role="strong">14:53:27</emphasis>
  619. </entry>
  620. </row>
  621. <row>
  622. <entry>Zend_Date::TIME_SHORT</entry>
  623. <entry>Abbreviated time (string, localized, abbreviated)</entry>
  624. <entry>2009-02-13T14:53:27+01:00</entry>
  625. <entry><emphasis role="strong">14:53</emphasis>
  626. </entry>
  627. </row>
  628. </tbody>
  629. </tgroup>
  630. </table>
  631. </sect2>
  632. <sect2 id="zend.date.constants.selfdefinedformats">
  633. <title> 自定义 ISO 输出格式 </title>
  634. <para>
  635. 如果你需要的日期格式没有在上述的格式中出现,那么使用从下面 ISO 格式指定器产生的自定义格式。
  636. 下面的例子示例了从下列表中生成的自定义 ISO 格式的常量的用法。格式长度无限制。并且允许格式常量的多重用法。
  637. </para>
  638. <para>
  639. 如果你喜欢的话,可接受的格式指定器可以从 ISO 格式修改为 PHP 的日期格式,然而,PHP 日期格式指定不支持所有的按 ISO 标准定义的格式。
  640. 使用 <code>Zend_Date::setOptions(array('format_type' => 'php'))</code> 方法来把 Zend_Date 方法从支持 ISO 格式制定器切换到 PHP date()类型制定器(参见下面 <xref linkend="zend.date.constants.phpformats" />)。
  641. </para>
  642. <example id="zend.date.constants.selfdefinedformats.example-1">
  643. <title> 自定义 ISO 格式用法示例 </title>
  644. <programlisting role="php"><![CDATA[
  645. $locale = new Zend_Locale('de_AT');
  646. $date = new Zend_Date(1234567890, false, $locale);
  647. print $date->toString("'Era:GGGG='GGGG, ' Date:yy.MMMM.dd'yy.MMMM.dd");
  648. ]]>
  649. </programlisting>
  650. </example>
  651. <table id="zend.date.constants.selfdefinedformats.table">
  652. <title> <emphasis role="strong">ISO 8601 日期输出 </emphasis> 常量
  653. </title>
  654. <tgroup cols="4">
  655. <thead>
  656. <row>
  657. <entry> 常数 </entry>
  658. <entry> 描述 </entry>
  659. <entry> 日期 </entry>
  660. <entry> 受影响部分/例子 </entry>
  661. </row>
  662. </thead>
  663. <tbody>
  664. <row>
  665. <entry>G</entry>
  666. <entry>Epoch, localized, abbreviated</entry>
  667. <entry>Zend_Date::ERA</entry>
  668. <entry><emphasis role="strong">AD</emphasis>
  669. </entry>
  670. </row>
  671. <row>
  672. <entry>GG</entry>
  673. <entry>Epoch, localized, abbreviated</entry>
  674. <entry>Zend_Date::ERA</entry>
  675. <entry><emphasis role="strong">AD</emphasis>
  676. </entry>
  677. </row>
  678. <row>
  679. <entry>GGG</entry>
  680. <entry>Epoch, localized, abbreviated</entry>
  681. <entry>Zend_Date::ERA</entry>
  682. <entry><emphasis role="strong">AD</emphasis>
  683. </entry>
  684. </row>
  685. <row>
  686. <entry>GGGG</entry>
  687. <entry>Epoch, localized, complete</entry>
  688. <entry>Zend_Date::ERA_NAME</entry>
  689. <entry><emphasis role="strong">anno domini</emphasis>
  690. </entry>
  691. </row>
  692. <row>
  693. <entry>GGGGG</entry>
  694. <entry>Epoch, localized, abbreviated</entry>
  695. <entry>Zend_Date::ERA</entry>
  696. <entry><emphasis role="strong">a</emphasis>
  697. </entry>
  698. </row>
  699. <row>
  700. <entry>y</entry>
  701. <entry>Year, at least one digit</entry>
  702. <entry>Zend_Date::YEAR</entry>
  703. <entry><emphasis role="strong">9</emphasis>
  704. </entry>
  705. </row>
  706. <row>
  707. <entry>yy</entry>
  708. <entry>Year, at least two digit</entry>
  709. <entry>Zend_Date::YEAR_SHORT</entry>
  710. <entry><emphasis role="strong">09</emphasis>
  711. </entry>
  712. </row>
  713. <row>
  714. <entry>yyy</entry>
  715. <entry>Year, at least three digit</entry>
  716. <entry>Zend_Date::YEAR</entry>
  717. <entry><emphasis role="strong">2009</emphasis>
  718. </entry>
  719. </row>
  720. <row>
  721. <entry>yyyy</entry>
  722. <entry>Year, at least four digit</entry>
  723. <entry>Zend_Date::YEAR</entry>
  724. <entry><emphasis role="strong">2009</emphasis>
  725. </entry>
  726. </row>
  727. <row>
  728. <entry>yyyyy</entry>
  729. <entry>Year, at least five digit</entry>
  730. <entry>Zend_Date::YEAR</entry>
  731. <entry><emphasis role="strong">02009</emphasis>
  732. </entry>
  733. </row>
  734. <row>
  735. <entry>Y</entry>
  736. <entry>Year according to ISO 8601, at least one digit</entry>
  737. <entry>Zend_Date::YEAR_8601</entry>
  738. <entry><emphasis role="strong">9</emphasis>
  739. </entry>
  740. </row>
  741. <row>
  742. <entry>YY</entry>
  743. <entry>Year according to ISO 8601, at least two digit</entry>
  744. <entry>Zend_Date::YEAR_SHORT_8601</entry>
  745. <entry><emphasis role="strong">09</emphasis>
  746. </entry>
  747. </row>
  748. <row>
  749. <entry>YYY</entry>
  750. <entry>Year according to ISO 8601, at least three digit</entry>
  751. <entry>Zend_Date::YEAR_8601</entry>
  752. <entry><emphasis role="strong">2009</emphasis>
  753. </entry>
  754. </row>
  755. <row>
  756. <entry>YYYY</entry>
  757. <entry>Year according to ISO 8601, at least four digit</entry>
  758. <entry>Zend_Date::YEAR_8601</entry>
  759. <entry><emphasis role="strong">2009</emphasis>
  760. </entry>
  761. </row>
  762. <row>
  763. <entry>YYYYY</entry>
  764. <entry>Year according to ISO 8601, at least five digit</entry>
  765. <entry>Zend_Date::YEAR_8601</entry>
  766. <entry><emphasis role="strong">02009</emphasis>
  767. </entry>
  768. </row>
  769. <row>
  770. <entry>M</entry>
  771. <entry>Month, one or two digit</entry>
  772. <entry>Zend_Date::MONTH_SHORT</entry>
  773. <entry><emphasis role="strong">2</emphasis>
  774. </entry>
  775. </row>
  776. <row>
  777. <entry>MM</entry>
  778. <entry>Month, two digit</entry>
  779. <entry>Zend_Date::MONTH</entry>
  780. <entry><emphasis role="strong">02</emphasis>
  781. </entry>
  782. </row>
  783. <row>
  784. <entry>MMM</entry>
  785. <entry>Month, localized, abbreviated</entry>
  786. <entry>Zend_Date::MONTH_NAME_SHORT</entry>
  787. <entry><emphasis role="strong">Feb</emphasis>
  788. </entry>
  789. </row>
  790. <row>
  791. <entry>MMMM</entry>
  792. <entry>Month, localized, complete</entry>
  793. <entry>Zend_Date::MONTH_NAME</entry>
  794. <entry><emphasis role="strong">February</emphasis>
  795. </entry>
  796. </row>
  797. <row>
  798. <entry>MMMMM</entry>
  799. <entry>Month, localized, abbreviated, one digit</entry>
  800. <entry>Zend_Date::MONTH_NAME_NARROW</entry>
  801. <entry><emphasis role="strong">F</emphasis>
  802. </entry>
  803. </row>
  804. <row>
  805. <entry>w</entry>
  806. <entry>Week, one or two digit</entry>
  807. <entry>Zend_Date::WEEK</entry>
  808. <entry><emphasis role="strong">5</emphasis>
  809. </entry>
  810. </row>
  811. <row>
  812. <entry>ww</entry>
  813. <entry>Week, two digit</entry>
  814. <entry>Zend_Date::WEEK</entry>
  815. <entry><emphasis role="strong">05</emphasis>
  816. </entry>
  817. </row>
  818. <row>
  819. <entry>d</entry>
  820. <entry>Day of the month, one or two digit</entry>
  821. <entry>Zend_Date::DAY_SHORT</entry>
  822. <entry><emphasis role="strong">9</emphasis>
  823. </entry>
  824. </row>
  825. <row>
  826. <entry>dd</entry>
  827. <entry>Day of the month, two digit</entry>
  828. <entry>Zend_Date::DAY</entry>
  829. <entry><emphasis role="strong">09</emphasis>
  830. </entry>
  831. </row>
  832. <row>
  833. <entry>D</entry>
  834. <entry>Day of the year, one, two or three digit</entry>
  835. <entry>Zend_Date::DAY_OF_YEAR</entry>
  836. <entry><emphasis role="strong">7</emphasis>
  837. </entry>
  838. </row>
  839. <row>
  840. <entry>DD</entry>
  841. <entry>Day of the year, two or three digit</entry>
  842. <entry>Zend_Date::DAY_OF_YEAR</entry>
  843. <entry><emphasis role="strong">07</emphasis>
  844. </entry>
  845. </row>
  846. <row>
  847. <entry>DDD</entry>
  848. <entry>Day of the year, three digit</entry>
  849. <entry>Zend_Date::DAY_OF_YEAR</entry>
  850. <entry><emphasis role="strong">007</emphasis>
  851. </entry>
  852. </row>
  853. <row>
  854. <entry>E</entry>
  855. <entry>Day of the week, localized, abbreviated, one char</entry>
  856. <entry>Zend_Date::WEEKDAY_NARROW</entry>
  857. <entry><emphasis role="strong">M</emphasis>
  858. </entry>
  859. </row>
  860. <row>
  861. <entry>EE</entry>
  862. <entry>Day of the week, localized, abbreviated, two char</entry>
  863. <entry>Zend_Date::WEEKDAY_NAME</entry>
  864. <entry><emphasis role="strong">Mo</emphasis>
  865. </entry>
  866. </row>
  867. <row>
  868. <entry>EEE</entry>
  869. <entry>Day of the week, localized, abbreviated, three char</entry>
  870. <entry>Zend_Date::WEEKDAY_SHORT</entry>
  871. <entry><emphasis role="strong">Mon</emphasis>
  872. </entry>
  873. </row>
  874. <row>
  875. <entry>EEEE</entry>
  876. <entry>Day of the week, localized, complete</entry>
  877. <entry>Zend_Date::WEEKDAY</entry>
  878. <entry><emphasis role="strong">Monday</emphasis>
  879. </entry>
  880. </row>
  881. <row>
  882. <entry>EEEEE</entry>
  883. <entry>Day of the week, localized, abbreviated, one digit</entry>
  884. <entry>Zend_Date::WEEKDAY_NARROW</entry>
  885. <entry><emphasis role="strong">M</emphasis>
  886. </entry>
  887. </row>
  888. <row>
  889. <entry>e</entry>
  890. <entry>Number of the day, one digit</entry>
  891. <entry>Zend_Date::WEEKDAY_NARROW</entry>
  892. <entry><emphasis role="strong">4</emphasis>
  893. </entry>
  894. </row>
  895. <row>
  896. <entry>ee</entry>
  897. <entry>Number of the day, two digit</entry>
  898. <entry>Zend_Date::WEEKDAY_NARROW</entry>
  899. <entry><emphasis role="strong">04</emphasis>
  900. </entry>
  901. </row>
  902. <row>
  903. <entry>a</entry>
  904. <entry>Time of day, localized</entry>
  905. <entry>Zend_Date::MERIDIEM</entry>
  906. <entry><emphasis role="strong">vorm.</emphasis>
  907. </entry>
  908. </row>
  909. <row>
  910. <entry>h</entry>
  911. <entry>Hour, (1-12), one or two digit</entry>
  912. <entry>Zend_Date::HOUR_SHORT_AM</entry>
  913. <entry><emphasis role="strong">2</emphasis>
  914. </entry>
  915. </row>
  916. <row>
  917. <entry>hh</entry>
  918. <entry>Hour, (01-12), two digit</entry>
  919. <entry>Zend_Date::HOUR_AM</entry>
  920. <entry><emphasis role="strong">02</emphasis>
  921. </entry>
  922. </row>
  923. <row>
  924. <entry>H</entry>
  925. <entry>Hour, (0-23), one or two digit</entry>
  926. <entry>Zend_Date::HOUR_SHORT</entry>
  927. <entry><emphasis role="strong">2</emphasis>
  928. </entry>
  929. </row>
  930. <row>
  931. <entry>HH</entry>
  932. <entry>Hour, (00-23), two digit</entry>
  933. <entry>Zend_Date::HOUR</entry>
  934. <entry><emphasis role="strong">02</emphasis>
  935. </entry>
  936. </row>
  937. <row>
  938. <entry>m</entry>
  939. <entry>Minute, (0-59), one or two digit</entry>
  940. <entry>Zend_Date::MINUTE_SHORT</entry>
  941. <entry><emphasis role="strong">2</emphasis>
  942. </entry>
  943. </row>
  944. <row>
  945. <entry>mm</entry>
  946. <entry>Minute, (00-59), two digit</entry>
  947. <entry>Zend_Date::MINUTE</entry>
  948. <entry><emphasis role="strong">02</emphasis>
  949. </entry>
  950. </row>
  951. <row>
  952. <entry>s</entry>
  953. <entry>Second, (0-59), one or two digit</entry>
  954. <entry>Zend_Date::SECOND_SHORT</entry>
  955. <entry><emphasis role="strong">2</emphasis>
  956. </entry>
  957. </row>
  958. <row>
  959. <entry>ss</entry>
  960. <entry>Second, (00-59), two digit</entry>
  961. <entry>Zend_Date::SECOND</entry>
  962. <entry><emphasis role="strong">02</emphasis>
  963. </entry>
  964. </row>
  965. <row>
  966. <entry>S</entry>
  967. <entry>Millisecond</entry>
  968. <entry>Zend_Date::MILLISECOND</entry>
  969. <entry><emphasis role="strong">20536</emphasis>
  970. </entry>
  971. </row>
  972. <row>
  973. <entry>z</entry>
  974. <entry>Time zone, localized, abbreviated</entry>
  975. <entry>Zend_Date::TIMEZONE</entry>
  976. <entry><emphasis role="strong">CET</emphasis>
  977. </entry>
  978. </row>
  979. <row>
  980. <entry>zz</entry>
  981. <entry>Time zone, localized, abbreviated</entry>
  982. <entry>Zend_Date::TIMEZONE</entry>
  983. <entry><emphasis role="strong">CET</emphasis>
  984. </entry>
  985. </row>
  986. <row>
  987. <entry>zzz</entry>
  988. <entry>Time zone, localized, abbreviated</entry>
  989. <entry>Zend_Date::TIMEZONE</entry>
  990. <entry><emphasis role="strong">CET</emphasis>
  991. </entry>
  992. </row>
  993. <row>
  994. <entry>zzzz</entry>
  995. <entry>Time zone, localized, complete</entry>
  996. <entry>Zend_Date::TIMEZONE_NAME</entry>
  997. <entry><emphasis role="strong">Europe/Paris</emphasis>
  998. </entry>
  999. </row>
  1000. <row>
  1001. <entry>Z</entry>
  1002. <entry>Difference of time zone</entry>
  1003. <entry>Zend_Date::GMT_DIFF</entry>
  1004. <entry><emphasis role="strong">+0100</emphasis>
  1005. </entry>
  1006. </row>
  1007. <row>
  1008. <entry>ZZ</entry>
  1009. <entry>Difference of time zone</entry>
  1010. <entry>Zend_Date::GMT_DIFF</entry>
  1011. <entry><emphasis role="strong">+0100</emphasis>
  1012. </entry>
  1013. </row>
  1014. <row>
  1015. <entry>ZZZ</entry>
  1016. <entry>Difference of time zone</entry>
  1017. <entry>Zend_Date::GMT_DIFF</entry>
  1018. <entry><emphasis role="strong">+0100</emphasis>
  1019. </entry>
  1020. </row>
  1021. <row>
  1022. <entry>ZZZZ</entry>
  1023. <entry>Difference of time zone, separated</entry>
  1024. <entry>Zend_Date::GMT_DIFF_SEP</entry>
  1025. <entry><emphasis role="strong">+01:00</emphasis>
  1026. </entry>
  1027. </row>
  1028. <row>
  1029. <entry>A</entry>
  1030. <entry>Millisecond</entry>
  1031. <entry>Zend_Date::MILLISECOND</entry>
  1032. <entry><emphasis role="strong">20563</emphasis>
  1033. </entry>
  1034. </row>
  1035. </tbody>
  1036. </tgroup>
  1037. </table>
  1038. <note>
  1039. <para>
  1040. 注意缺省的 ISO 格式不同于 PHP 的格式,如果在先前没有使用,PHP 的格式可以迭代。
  1041. 特别是 <emphasis role="strong">Year and Minute</emphasis> 的格式指定器不常按预期来使用。
  1042. </para>
  1043. <para>
  1044. 对于 <emphasis role="strong">year</emphasis> 有两个可用的指定器经常发生错误:
  1045. ISO 年的<emphasis role="strong">Y</emphasis> 指定器和真实年的 <emphasis role="strong">y</emphasis> 的指定器。
  1046. 区别微小但意义重大。
  1047. <emphasis role="strong">Y</emphasis> 计算 ISO 年,常用于日历格式,例如 the 31. December 2007。
  1048. 真实年为 2007,但它是 2008 年的第一周的第一天,所以,如果使用 'dd.MM.yyyy' 会得到 '31.December.2007' 但如果使用 'dd.MM.YYYY' 会得到 '31.December.2008'。
  1049. 正如你所看到的,这不是 bug , 但期望的行为依赖指定器的使用。
  1050. </para>
  1051. <para>
  1052. 对 <emphasis role="strong">minute</emphasis> 来说区别不大。ISO 使用 <emphasis role="strong">m</emphasis> 指定器,PHP 使用 <emphasis role="strong">i</emphasis>。
  1053. 所以如果没有按你的格式获得分钟数,检查是否使用了正确的指定器。
  1054. </para>
  1055. </note>
  1056. </sect2>
  1057. <sect2 id="zend.date.constants.phpformats">
  1058. <title> 使用 PHP 的 date() 格式指定器的自定义输出格式 </title>
  1059. <para>
  1060. 如果你更喜欢使用 PHP 的日期格式指定器,可以使用 <code>Zend_Date::setOptions(array('format' => 'php'))</code> 方法
  1061. 把 Zend_Date 方法从支持 ISO 格式制定器切换到 PHP date()类型制定器。然后所有参数必需用 <ulink url="http://php.net/date">PHP's <code>date()</code> 格式指定器 </ulink> 给出。
  1062. PHP 日期格式缺乏一些 ISO 格式支持的格式,反之亦然。如果不喜欢,可以使用标准的 ISO 格式。
  1063. 而且,如果你有一些历史遗留的使用 PHP 日期格式的代码,可以用 <link linkend="zend.locale.date.normalize">Zend_Locale_Format::convertPhpToIsoFormat()</link> 手工转换为 ISO 格式,或使用 <code>setOptions()</code>。
  1064. 下面的例子示例了从下表生成的自定义格式的常量的用法。
  1065. </para>
  1066. <example id="zend.date.constants.phpformats.example-1">
  1067. <title> 用 PHP 指定器自定义格式的用例 </title>
  1068. <programlisting role="php"><![CDATA[
  1069. $locale = new Zend_Locale('de_AT');
  1070. Zend_Date::setOptions(array('format_type' => 'php'));
  1071. $date = new Zend_Date(1234567890, false, $locale);
  1072. // outputs something like 'February 16, 2007, 3:36 am'
  1073. print $date->toString('F j, Y, g:i a');
  1074. print $date->toString("'Format:D M j G:i:s T Y='D M j G:i:s T Y");
  1075. ]]>
  1076. </programlisting>
  1077. </example>
  1078. <para>
  1079. 下标列出了带有相应等同的 Zend_Date常量和 CLDR/ISO 格式指定器的 PHP 日期格式指定器。
  1080. 对一些情况,当 CLDR/ISO 格式没有等同的格式指定器时,PHP 格式指定器不用 <code>Zend_Locale_Format::convertPhpToIsoFormat()</code> 来改变,
  1081. 并且 Zend_Date 方法承认这些 “奇特的” PHP 格式指定器,即使是处于缺省的 "ISO" 格式模式中。
  1082. </para>
  1083. <table id="zend.date.constants.phpformats.table">
  1084. <title> <emphasis role="strong">PHP 日期输出 </emphasis> 常量
  1085. </title>
  1086. <tgroup cols="5">
  1087. <thead>
  1088. <row>
  1089. <entry> 常数 </entry>
  1090. <entry> 描述 </entry>
  1091. <entry>Corresponds best to</entry>
  1092. <entry>closest CLDR equivalent</entry>
  1093. <entry> 受影响部分/例子 </entry>
  1094. </row>
  1095. </thead>
  1096. <tbody>
  1097. <row>
  1098. <entry>d</entry>
  1099. <entry>Day of the month, two digit</entry>
  1100. <entry>Zend_Date::DAY</entry>
  1101. <entry>dd</entry>
  1102. <entry><emphasis role="strong">09</emphasis>
  1103. </entry>
  1104. </row>
  1105. <row>
  1106. <entry>D</entry>
  1107. <entry>Day of the week, localized, abbreviated, three digit</entry>
  1108. <entry>Zend_Date::WEEKDAY_SHORT</entry>
  1109. <entry>EEE</entry>
  1110. <entry><emphasis role="strong">Mon</emphasis>
  1111. </entry>
  1112. </row>
  1113. <row>
  1114. <entry>j</entry>
  1115. <entry>Day of the month, one or two digit</entry>
  1116. <entry>Zend_Date::DAY_SHORT</entry>
  1117. <entry>d</entry>
  1118. <entry><emphasis role="strong">9</emphasis>
  1119. </entry>
  1120. </row>
  1121. <row>
  1122. <entry>l (lowercase L)</entry>
  1123. <entry>Day of the week, localized, complete</entry>
  1124. <entry>Zend_Date::WEEKDAY</entry>
  1125. <entry>EEEE</entry>
  1126. <entry><emphasis role="strong">Monday</emphasis>
  1127. </entry>
  1128. </row>
  1129. <row>
  1130. <entry>N</entry>
  1131. <entry>Number of the weekday, one digit</entry>
  1132. <entry>Zend_Date::WEEKDAY_8601</entry>
  1133. <entry>e</entry>
  1134. <entry><emphasis role="strong">4</emphasis>
  1135. </entry>
  1136. </row>
  1137. <row>
  1138. <entry>S</entry>
  1139. <entry>English suffixes for day of month, two chars</entry>
  1140. <entry>no equivalent</entry>
  1141. <entry>no equivalent</entry>
  1142. <entry><emphasis role="strong">st</emphasis>
  1143. </entry>
  1144. </row>
  1145. <row>
  1146. <entry>w</entry>
  1147. <entry>Number of the weekday, 0=sunday, 6=saturday</entry>
  1148. <entry>Zend_Date::WEEKDAY_DIGIT</entry>
  1149. <entry>no equivalent</entry>
  1150. <entry><emphasis role="strong">4</emphasis>
  1151. </entry>
  1152. </row>
  1153. <row>
  1154. <entry>z</entry>
  1155. <entry>Day of the year, one, two or three digit</entry>
  1156. <entry>Zend_Date::DAY_OF_YEAR</entry>
  1157. <entry>D</entry>
  1158. <entry><emphasis role="strong">7</emphasis>
  1159. </entry>
  1160. </row>
  1161. <row>
  1162. <entry>W</entry>
  1163. <entry>Week, one or two digit</entry>
  1164. <entry>Zend_Date::WEEK</entry>
  1165. <entry>w</entry>
  1166. <entry><emphasis role="strong">5</emphasis>
  1167. </entry>
  1168. </row>
  1169. <row>
  1170. <entry>F</entry>
  1171. <entry>Month, localized, complete</entry>
  1172. <entry>Zend_Date::MONTH_NAME</entry>
  1173. <entry>MMMM</entry>
  1174. <entry><emphasis role="strong">February</emphasis>
  1175. </entry>
  1176. </row>
  1177. <row>
  1178. <entry>m</entry>
  1179. <entry>Month, two digit</entry>
  1180. <entry>Zend_Date::MONTH</entry>
  1181. <entry>MM</entry>
  1182. <entry><emphasis role="strong">02</emphasis>
  1183. </entry>
  1184. </row>
  1185. <row>
  1186. <entry>M</entry>
  1187. <entry>Month, localized, abbreviated</entry>
  1188. <entry>Zend_Date::MONTH_NAME_SHORT</entry>
  1189. <entry>MMM</entry>
  1190. <entry><emphasis role="strong">Feb</emphasis>
  1191. </entry>
  1192. </row>
  1193. <row>
  1194. <entry>n</entry>
  1195. <entry>Month, one or two digit</entry>
  1196. <entry>Zend_Date::MONTH_SHORT</entry>
  1197. <entry>M</entry>
  1198. <entry><emphasis role="strong">2</emphasis>
  1199. </entry>
  1200. </row>
  1201. <row>
  1202. <entry>t</entry>
  1203. <entry>Number of days per month, one or two digits</entry>
  1204. <entry>Zend_Date::MONTH_DAYS</entry>
  1205. <entry>no equivalent</entry>
  1206. <entry><emphasis role="strong">30</emphasis>
  1207. </entry>
  1208. </row>
  1209. <row>
  1210. <entry>L</entry>
  1211. <entry>Leapyear, boolean</entry>
  1212. <entry>Zend_Date::LEAPYEAR</entry>
  1213. <entry>no equivalent</entry>
  1214. <entry><emphasis role="strong">true</emphasis>
  1215. </entry>
  1216. </row>
  1217. <row>
  1218. <entry>o</entry>
  1219. <entry>Year according to ISO 8601, at least four digit</entry>
  1220. <entry>Zend_Date::YEAR_8601</entry>
  1221. <entry>YYYY</entry>
  1222. <entry><emphasis role="strong">2009</emphasis>
  1223. </entry>
  1224. </row>
  1225. <row>
  1226. <entry>Y</entry>
  1227. <entry>Year, at least four digit</entry>
  1228. <entry>Zend_Date::YEAR</entry>
  1229. <entry>yyyy</entry>
  1230. <entry><emphasis role="strong">2009</emphasis>
  1231. </entry>
  1232. </row>
  1233. <row>
  1234. <entry>y</entry>
  1235. <entry>Year, at least two digit</entry>
  1236. <entry>Zend_Date::YEAR_SHORT</entry>
  1237. <entry>yy</entry>
  1238. <entry><emphasis role="strong">09</emphasis>
  1239. </entry>
  1240. </row>
  1241. <row>
  1242. <entry>a</entry>
  1243. <entry>Time of day, localized</entry>
  1244. <entry>Zend_Date::MERIDIEM</entry>
  1245. <entry>a (sort of, but likely to be uppercase)</entry>
  1246. <entry><emphasis role="strong">vorm.</emphasis>
  1247. </entry>
  1248. </row>
  1249. <row>
  1250. <entry>A</entry>
  1251. <entry>Time of day, localized</entry>
  1252. <entry>Zend_Date::MERIDIEM</entry>
  1253. <entry>a (sort of, but no guarantee that the format is uppercase)</entry>
  1254. <entry><emphasis role="strong">VORM.</emphasis>
  1255. </entry>
  1256. </row>
  1257. <row>
  1258. <entry>B</entry>
  1259. <entry>Swatch internet time</entry>
  1260. <entry>Zend_Date::SWATCH</entry>
  1261. <entry>no equivalent</entry>
  1262. <entry><emphasis role="strong">1463</emphasis>
  1263. </entry>
  1264. </row>
  1265. <row>
  1266. <entry>g</entry>
  1267. <entry>Hour, (1-12), one or two digit</entry>
  1268. <entry>Zend_Date::HOUR_SHORT_AM</entry>
  1269. <entry>h</entry>
  1270. <entry><emphasis role="strong">2</emphasis>
  1271. </entry>
  1272. </row>
  1273. <row>
  1274. <entry>G</entry>
  1275. <entry>Hour, (0-23), one or two digit</entry>
  1276. <entry>Zend_Date::HOUR_SHORT</entry>
  1277. <entry>H</entry>
  1278. <entry><emphasis role="strong">2</emphasis>
  1279. </entry>
  1280. </row>
  1281. <row>
  1282. <entry>h</entry>
  1283. <entry>Hour, (01-12), two digit</entry>
  1284. <entry>Zend_Date::HOUR_AM</entry>
  1285. <entry>hh</entry>
  1286. <entry><emphasis role="strong">02</emphasis>
  1287. </entry>
  1288. </row>
  1289. <row>
  1290. <entry>H</entry>
  1291. <entry>Hour, (00-23), two digit</entry>
  1292. <entry>Zend_Date::HOUR</entry>
  1293. <entry>HH</entry>
  1294. <entry><emphasis role="strong">02</emphasis>
  1295. </entry>
  1296. </row>
  1297. <row>
  1298. <entry>i</entry>
  1299. <entry>Minute, (00-59), two digit</entry>
  1300. <entry>Zend_Date::MINUTE</entry>
  1301. <entry>mm</entry>
  1302. <entry><emphasis role="strong">02</emphasis>
  1303. </entry>
  1304. </row>
  1305. <row>
  1306. <entry>s</entry>
  1307. <entry>Second, (00-59), two digit</entry>
  1308. <entry>Zend_Date::SECOND</entry>
  1309. <entry>ss</entry>
  1310. <entry><emphasis role="strong">02</emphasis>
  1311. </entry>
  1312. </row>
  1313. <row>
  1314. <entry>e</entry>
  1315. <entry>Time zone, localized, complete</entry>
  1316. <entry>Zend_Date::TIMEZONE_NAME</entry>
  1317. <entry>zzzz</entry>
  1318. <entry><emphasis role="strong">Europe/Paris</emphasis>
  1319. </entry>
  1320. </row>
  1321. <row>
  1322. <entry>I</entry>
  1323. <entry>Daylight</entry>
  1324. <entry>Zend_Date::DAYLIGHT</entry>
  1325. <entry>no equivalent</entry>
  1326. <entry><emphasis role="strong">1</emphasis>
  1327. </entry>
  1328. </row>
  1329. <row>
  1330. <entry>O</entry>
  1331. <entry>Difference of time zone</entry>
  1332. <entry>Zend_Date::GMT_DIFF</entry>
  1333. <entry>Z or ZZ or ZZZ</entry>
  1334. <entry><emphasis role="strong">+0100</emphasis>
  1335. </entry>
  1336. </row>
  1337. <row>
  1338. <entry>P</entry>
  1339. <entry>Difference of time zone, separated</entry>
  1340. <entry>Zend_Date::GMT_DIFF_SEP</entry>
  1341. <entry>ZZZZ</entry>
  1342. <entry><emphasis role="strong">+01:00</emphasis>
  1343. </entry>
  1344. </row>
  1345. <row>
  1346. <entry>T</entry>
  1347. <entry>Time zone, localized, abbreviated</entry>
  1348. <entry>Zend_Date::TIMEZONE</entry>
  1349. <entry>z or zz or zzz</entry>
  1350. <entry><emphasis role="strong">CET</emphasis>
  1351. </entry>
  1352. </row>
  1353. <row>
  1354. <entry>Z</entry>
  1355. <entry>Time zone offset in seconds</entry>
  1356. <entry>Zend_Date::TIMEZONE_SECS</entry>
  1357. <entry>no equivalent</entry>
  1358. <entry><emphasis role="strong">3600</emphasis>
  1359. </entry>
  1360. </row>
  1361. <row>
  1362. <entry>c</entry>
  1363. <entry>Standard Iso format output</entry>
  1364. <entry>Zend_Date::ISO_8601</entry>
  1365. <entry>no equivalent</entry>
  1366. <entry><emphasis role="strong">2004-02-12T15:19:21+00:00</emphasis>
  1367. </entry>
  1368. </row>
  1369. <row>
  1370. <entry>r</entry>
  1371. <entry>Standard Rfc 2822 format output</entry>
  1372. <entry>Zend_Date::RFC_2822</entry>
  1373. <entry>no equivalent</entry>
  1374. <entry><emphasis role="strong">Thu, 21 Dec 2000 16:01:07 +0200</emphasis>
  1375. </entry>
  1376. </row>
  1377. <row>
  1378. <entry>U</entry>
  1379. <entry>Unix timestamp</entry>
  1380. <entry>Zend_Date::TIMESTAMP</entry>
  1381. <entry>no equivalent</entry>
  1382. <entry><emphasis role="strong">15275422364</emphasis>
  1383. </entry>
  1384. </row>
  1385. </tbody>
  1386. </tgroup>
  1387. </table>
  1388. </sect2>
  1389. </sect1>