cvs: phpdoc-zh /reference/datetime/functions date.xml gmdate.xml gmstrftime.xml
| From: | Dallas Thunder | Date: | Mon, 24 Feb 2003 06:38:24 +0000 |
| Subject: | cvs: phpdoc-zh /reference/datetime/functions date.xml gmdate.xml gmstrftime.xml | ||
| Groups: | php.doc.zh | ||
| Request: | Send a blank email to doc-zh+get-1102@lists.php.net to get a copy of this message | ||
dallas Mon Feb 24 01:38:24 2003 EDT
Modified files:
/phpdoc-zh/reference/datetime/functions date.xml gmdate.xml
gmstrftime.xml
Log:
Updated.
Index: phpdoc-zh/reference/datetime/functions/date.xml diff -u phpdoc-zh/reference/datetime/functions/date.xml:1.4 phpdoc-zh/reference/datetime/functions/date.xml:1.5 --- phpdoc-zh/reference/datetime/functions/date.xml:1.4 Sun Sep 29 23:07:33 2002 +++ phpdoc-zh/reference/datetime/functions/date.xml Mon Feb 24 01:38:24 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- $Author: dallas $ --> -<!-- EN-Revision: 1.4 Maintainer: dallas Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: dallas Status: ready --> <refentry id="function.date"> <refnamediv> <refname>date</refname> @@ -18,7 +18,8 @@ </methodsynopsis> <para> ·µ»Ø½«ÕûÊý <parameter>timestamp</parameter> - °´ÕÕ¸ø¶¨µÄ¸ñʽ×Ö´®¶ø²úÉúµÄ×Ö·û´®¡£Èç¹ûûÓиø³öʱ¼ä´ÁÔòʹÓñ¾µØµ±Ç°Ê±¼ä¡£ + °´ÕÕ¸ø¶¨µÄ¸ñʽ×Ö´®¶ø²úÉúµÄ×Ö·û´®¡£Èç¹ûûÓиø³öʱ¼ä´ÁÔòʹÓñ¾µØµ±Ç°Ê±¼ä¡£»»¾ä»°Ëµ£¬<parameter>timestamp</parameter> + ÊÇ¿ÉÑ¡µÄ£¬Ä¬ÈÏֵΪ <function>time</function>¡£ <note> <para> ÓÐЧµÄʱ¼ä´ÁµäÐÍ·¶Î§ÊǸñÁÖÍþÖÎʱ¼ä 1901 Äê 12 Ô 13 ÈÕ 20:45:54 @@ -29,182 +30,200 @@ <para> Òª½«×Ö·û´®±í´ïµÄʱ¼äת»»³Éʱ¼ä´Á£¬Ó¦¸ÃʹÓà <function>strtotime</function>¡£´ËÍâһЩÊý¾Ý¿âÓÐһЩº¯Êý½«Æäʱ¼ä¸ñʽת»»³Éʱ¼ä´Á£¨ÀýÈç - MySQL µÄ UNIX_TIMESTAMP º¯Êý£©¡£ + MySQL µÄ <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> º¯Êý£©¡£ </para> </note> </para> <para> - ¸ñʽ×Ö´®¿ÉÒÔʶ±ðÒÔÏÂ×Ö·û£º - <itemizedlist> - <listitem> - <simpara> - a - "am" »ò "pm" - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" »ò "PM" - </simpara> - </listitem> - <listitem> - <simpara> - B - Swatch Internet Time£¨¡¾ÒëÕß×¢¡¿²Î¼û http://swatch.com/alu_beat/fs_itime.html£© - </simpara> - </listitem> - <listitem> - <simpara> - d - Ô·ÝÖеĵڼ¸Ì죬ÓÐǰµ¼ÁãµÄ 2 λÊý×Ö£¬ÀýÈç "01" - to "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - ÐÇÆÚÖеĵڼ¸Ì죬Îı¾±íʾ£¬3 ¸ö×Öĸ£¬ÀýÈç "Fri" - </simpara> - </listitem> - <listitem> - <simpara> - F - Ô·ݣ¬ÍêÕûµÄÎı¾¸ñʽ£¬ÀýÈç "January" - </simpara> - </listitem> - <listitem> - <simpara> - g - Сʱ£¬12 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Á㣬ÀýÈç "1" µ½ "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - Сʱ£¬24 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Á㣬ÀýÈç "0" µ½ "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - Сʱ£¬12 Сʱ¸ñʽ£¬ÀýÈç "01" µ½ "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - Сʱ£¬24 Сʱ¸ñʽ£¬ÀýÈç "00" µ½ "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - ·ÖÖÓ£¬ÀýÈç "00" µ½ "59" - </simpara> - </listitem> - <listitem> - <simpara> - I£¨¡°i¡±µÄ´óдµÄ×Öĸ£©- Èç¹ûÊÇÏÄÁîʱÔòΪ "1"£¬·ñÔòΪ "0" - </simpara> - </listitem> - <listitem> - <simpara> - j - Ô·ÝÖеĵڼ¸Ì죬ûÓÐǰµ¼Á㣬ÀýÈç "1" µ½ "31" - </simpara> - </listitem> - <listitem> - <simpara> - l£¨¡°L¡±µÄСд×Öĸ£©- ÐÇÆÚÖеĵڼ¸Ì죬ÍêÕûµÄÎı¾¸ñʽ£¬ÀýÈç "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - L - ²¼¶ûÖµ±íʾÊÇ·ñΪÈòÄ꣬ÀýÈç "0" »òÕß "1" - </simpara> - </listitem> - <listitem> - <simpara> - m - Ô·ݣ¬ÀýÈç "01" to "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - Ô·ݣ¬Îı¾±íʾ£¬3 ¸ö×Öĸ£¬ÀýÈç "Jan" - </simpara> - </listitem> - <listitem> - <simpara> - n - Ô·ݣ¬Ã»ÓÐǰµ¼Á㣬ÀýÈç "1" µ½ "12" - </simpara> - </listitem> - <listitem> - <simpara> - O - Óë¸ñÁÖÍþÖÎʱ¼äÏà²îµÄСʱÊý£¬ÀýÈç "+0200" - </simpara> - </listitem> - <listitem> - <simpara> - r - RFC 822 ¸ñʽµÄÈÕÆÚ£¬ÀýÈç "Thu, 21 Dec 2000 16:01:07 +0200"£¨PHP 4.0.4ÐÂÔö£© - </simpara> - </listitem> - <listitem> - <simpara> - s - ÃëÊý£¬ÀýÈç "00" µ½ "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - ÿÔÂÌìÊýºóÃæµÄÓ¢Îĺó׺£¬2 ¸ö×Ö·û£¬ÀýÈç "st"£¬"nd"£¬"rd" »òÕß "th" - </simpara> - </listitem> - <listitem> - <simpara> - t - ¸ø¶¨Ô·ÝËùÓ¦ÓеÄÌìÊý£¬ÀýÈç "28" µ½ "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - ±¾»úËùÔÚµÄÊ±Çø£¬ÀýÈç "EST" »ò "MDT"£¨¡¾ÒëÕß×¢¡¿ÔÚ Windows - ÏÂΪÍêÕûÎı¾¸ñʽ£¬ÀýÈç¡°Eastern Standard Time¡±£¬ÖÐÎİæ»áÏÔʾ¡°Öйú±ê׼ʱ¼ä¡±¡££© - </simpara> - </listitem> - <listitem> - <simpara> - U - ´Ó Unix ¼ÍÔª£¨January 1 1970 00:00:00 GMT£©¿ªÊ¼ÖÁ½ñµÄÃëÊý - </simpara> - </listitem> - <listitem> - <simpara> - w - ÐÇÆÚÖеĵڼ¸Ì죬Êý×Ö±íʾ£¬ÀýÈç "0"£¨ÐÇÆÚÌ죩µ½ "6" - (Saturday) - </simpara> - </listitem> - <listitem> - <simpara> - W - ISO-8601 ¸ñʽÄê·ÝÖеĵڼ¸ÖÜ£¬Ã¿ÖÜ´ÓÐÇÆÚÒ»¿ªÊ¼£¨PHP 4.1.0 мӵģ© - </simpara> - </listitem> - <listitem> - <simpara> - Y - Äê·Ý£¬4 λÊý×Ö£¬ÀýÈç "1999" - </simpara> - </listitem> - <listitem> - <simpara> - y - Äê·Ñ£¬2 λÊý×Ö£¬ÀýÈç "99" - </simpara> - </listitem> - <listitem> - <simpara> - z - Äê·ÝÖеĵڼ¸Ì죬ÀýÈç "0" µ½ "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - ʱ²îÆ«ÒÆÁ¿µÄÃëÊý£¨ÀýÈç "-43200" µ½ "43200"£©¡£UTC Î÷±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊǸºµÄ£¬UTC - ¶«±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊÇÕýµÄ¡£ - </simpara> - </listitem> - </itemizedlist> - ¸ñʽ×Ö´®Öв»Äܱ»Ê¶±ðµÄ×Ö·û½«ÔÑùÏÔʾ¡£¡°Z¡±¸ñʽÔÚʹÓà <function>gmdate</function> ʱ×ÜÊÇ·µ»Ø¡°0¡±¡£ + <table> + <title>¸ñʽ×Ö´®¿ÉÒÔʶ±ðÒÔÏ <parameter>format</parameter> ²ÎÊýµÄ×Ö·û´®</title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>format</parameter> ×Ö·û</entry> + <entry>˵Ã÷</entry> + <entry>·µ»ØÖµÀý×Ó</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>a</literal></entry> + <entry>СдµÄÉÏÎçºÍÏÂÎçÖµ</entry> + <entry><literal>am</literal> »ò <literal>pm</literal></entry> + </row> + <row> + <entry><literal>A</literal></entry> + <entry>´óдµÄÉÏÎçºÍÏÂÎçÖµ</entry> + <entry><literal>AM</literal> »ò <literal>PM</literal></entry> + </row> + <row> + <entry><literal>B</literal></entry> + <entry>Swatch Internet ±ê׼ʱ</entry> + <entry><literal>000</literal> µ½ <literal>999</literal></entry> + </row> + <row> + <entry><literal>d</literal></entry> + <entry>Ô·ÝÖеĵڼ¸Ì죬ÓÐǰµ¼ÁãµÄ 2 λÊý×Ö</entry> + <entry><literal>01</literal> µ½ <literal>31</literal></entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>ÐÇÆÚÖеĵڼ¸Ì죬Îı¾±íʾ£¬3 ¸ö×Öĸ</entry> + <entry><literal>Mon</literal> µ½ <literal>Sun</literal></entry> + </row> + <row> + <entry><literal>F</literal></entry> + <entry>Ô·ݣ¬ÍêÕûµÄÎı¾¸ñʽ£¬ÀýÈç January »òÕß March</entry> + <entry><literal>January</literal> µ½ <literal>December</literal></entry> + </row> + <row> + <entry><literal>g</literal></entry> + <entry>Сʱ£¬12 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Áã</entry> + <entry><literal>1</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>G</literal></entry> + <entry>Сʱ£¬24 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Áã</entry> + <entry><literal>0</literal> µ½ <literal>23</literal></entry> + </row> + <row> + <entry><literal>h</literal></entry> + <entry>Сʱ£¬12 Сʱ¸ñʽ£¬ÓÐǰµ¼Áã</entry> + <entry><literal>01</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>H</literal></entry> + <entry>Сʱ£¬24 Сʱ¸ñʽ£¬ÓÐǰµ¼Áã</entry> + <entry><literal>00</literal> µ½ <literal>23</literal></entry> + </row> + <row> + <entry><literal>i</literal></entry> + <entry>ÓÐǰµ¼ÁãµÄ·ÖÖÓÊý</entry> + <entry><literal>00</literal> µ½ <literal>59</literal>></entry> + </row> + <row> + <entry><literal>I</literal></entry> + <entry>ÊÇ·ñΪÏÄÁîʱ</entry> + <entry>Èç¹ûÊÇÏÄÁîʱΪ <literal>1</literal>£¬·ñÔòΪ <literal>0</literal></entry> + </row> + <row> + <entry><literal>j</literal></entry> + <entry>Ô·ÝÖеĵڼ¸Ì죬ûÓÐǰµ¼Áã</entry> + <entry><literal>1</literal> µ½ <literal>31</literal></literal></entry> + </row> + <row> + <entry><literal>l</literal>£¨¡°L¡±µÄСд×Öĸ£©</entry> + <entry>ÐÇÆÚ¼¸£¬ÍêÕûµÄÎı¾¸ñʽ</entry> + <entry><literal>Sunday</literal> µ½ <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>ÊÇ·ñΪÈòÄê</entry> + <entry>Èç¹ûÊÇÈòÄêΪ <literal>1</literal>£¬·ñÔòΪ <literal>0</literal></entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>Êý×Ö±íʾµÄÔ·ݣ¬ÓÐǰµ¼Áã</entry> + <entry><literal>01</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>M</literal></entry> + <entry>Èý¸ö×ÖĸËõд±íʾµÄÔ·Ý</entry> + <entry><literal>Jan</literal> µ½ <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>n</literal></entry> + <entry>Êý×Ö±íʾµÄÔ·ݣ¬Ã»ÓÐǰµ¼Áã</entry> + <entry><literal>1</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>O</literal></entry> + <entry>Óë¸ñÁÖÍþÖÎʱ¼äÏà²îµÄСʱÊý</entry> + <entry>ÀýÈ磺<literal>+0200</literal></entry> + </row> + <row> + <entry><literal>r</literal></entry> + <entry>RFC 822 ¸ñʽµÄÈÕÆÚ</entry> + <entry>ÀýÈ磺<literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>ÃëÊý£¬ÓÐǰµ¼Áã</entry> + <entry><literal>00</literal> µ½ <literal>59</literal>></entry> + </row> + <row> + <entry><literal>S</literal></entry> + <entry>ÿÔÂÌìÊýºóÃæµÄÓ¢Îĺó׺£¬2 ¸ö×Ö·û</entry> + <entry><literal>st</literal>£¬<literal>nd</literal>£¬<literal>rd</literal> »òÕß <literal>th</literal>¡£¿ÉÒÔºÍ <literal>j</literal> Ò»ÆðÓá£</entry> + </row> + <row> + <entry><literal>t</literal></entry> + <entry>¸ø¶¨Ô·ÝËùÓ¦ÓеÄÌìÊý</entry> + <entry><literal>28</literal> µ½ <literal>31</literal></entry> + </row> + <row> + <entry><literal>T</literal></entry> + <entry>±¾»úËùÔÚµÄÊ±Çø</entry> + <entry>ÀýÈ磺<literal>EST</literal>£¬<literal>MDT</literal>£¨¡¾ÒëÕß×¢¡¿ÔÚ Windows + ÏÂΪÍêÕûÎı¾¸ñʽ£¬ÀýÈç¡°Eastern Standard Time¡±£¬ÖÐÎİæ»áÏÔʾ¡°Öйú±ê׼ʱ¼ä¡±£©¡£</entry> + </row> + <row> + <entry><literal>U</literal></entry> + <entry>´Ó Unix ¼ÍÔª£¨January 1 1970 00:00:00 GMT£©¿ªÊ¼ÖÁ½ñµÄÃëÊý</entry> + <entry>²Î¼û <function>time</function></entry> + </row> + <row> + <entry><literal>w</literal></entry> + <entry>ÐÇÆÚÖеĵڼ¸Ì죬Êý×Ö±íʾ</entry> + <entry><literal>0</literal>£¨±íʾÐÇÆÚÌ죩µ½ <literal>6</literal>£¨±íʾÐÇÆÚÁù£©</entry> + </row> + <row> + <entry><literal>W</literal></entry> + <entry>ISO-8601 ¸ñʽÄê·ÝÖеĵڼ¸ÖÜ£¬Ã¿ÖÜ´ÓÐÇÆÚÒ»¿ªÊ¼£¨PHP 4.1.0 мӵģ©</entry> + <entry>ÀýÈ磺<literal>42</literal>£¨µ±ÄêµÄµÚ 42 ÖÜ£©</entry> + </row> + <row> + <entry><literal>Y</literal></entry> + <entry>4 λÊý×ÖÍêÕû±íʾµÄÄê·Ý</entry> + <entry>ÀýÈ磺<literal>1999</literal> »ò <literal>2003</literal></entry> + </row> + <row> + <entry><literal>y</literal></entry> + <entry>2 λÊý×Ö±íʾµÄÄê·Ý</entry> + <entry>ÀýÈ磺<literal>99</literal> »ò <literal>03</literal></entry> + </row> + <row> + <entry><literal>z</literal></entry> + <entry>Äê·ÝÖеĵڼ¸Ìì</entry> + <entry><literal>0</literal> µ½ <literal>366</literal></entry> + </row> + <row> + <entry><literal>Z</literal></entry> + <entry>ʱ²îÆ«ÒÆÁ¿µÄÃëÊý¡£UTC Î÷±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊǸºµÄ£¬UTC ¶«±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊÇÕýµÄ¡£</entry> + <entry><literal>-43200</literal> µ½ <literal>43200</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + ¸ñʽ×Ö´®Öв»Äܱ»Ê¶±ðµÄ×Ö·û½«ÔÑùÏÔʾ¡£<literal>Z</literal> ¸ñʽÔÚʹÓà <function>gmdate</function> ʱ×ÜÊÇ·µ»Ø <literal>0</literal>¡£ </para> <para> <example> <title><function>date</function> Àý×Ó</title> <programlisting role="php"> <![CDATA[ +<?php +// Prints something like: Wednesday +echo date("l"); + +// Prints something like: Wednesday 15th of January 2003 05:51:38 AM echo date ("l dS of F Y h:i:s A"); + +// Prints: July 1, 2000 is on a Saturday echo "July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000)); +?> ]]> </programlisting> </example> @@ -215,7 +234,10 @@ <title>ÔÚ <function>date</function> ÖÐתÒå×Ö·û</title> <programlisting role="php"> <![CDATA[ -echo date("l \\t\h\e jS"); // ÏÔʾÀàËÆÓÚ£ºSaturday the 8th +<?php +// prints something like: Wednesday the 15th +echo date("l \\t\h\e jS"); +?> ]]> </programlisting> </example> @@ -229,9 +251,11 @@ </title> <programlisting role="php"> <![CDATA[ +<?php $tomorrow = mktime (0,0,0,date("m") ,date("d")+1,date("Y")); $lastmonth = mktime (0,0,0,date("m")-1,date("d"), date("Y")); $nextyear = mktime (0,0,0,date("m"), date("d"), date("Y")+1); +?> ]]> </programlisting> </example> @@ -251,7 +275,8 @@ </title> <programlisting role="php"> <![CDATA[ -/* Today is March 10th, 2001, 5:16:18 pm */ +<?php +// Assuming today is: March 10th, 2001, 5:16:18 pm $today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm $today = date("m.d.y"); // 03.10.01 $today = date("j, n, Y"); // 10, 3, 2001 @@ -261,6 +286,7 @@ $today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001 $today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month $today = date("H:i:s"); // 17:16:17 +?> ]]> </programlisting> </example> Index: phpdoc-zh/reference/datetime/functions/gmdate.xml diff -u phpdoc-zh/reference/datetime/functions/gmdate.xml:1.2 phpdoc-zh/reference/datetime/functions/gmdate.xml:1.3 --- phpdoc-zh/reference/datetime/functions/gmdate.xml:1.2 Sun Sep 29 23:07:33 2002 +++ phpdoc-zh/reference/datetime/functions/gmdate.xml Mon Feb 24 01:38:24 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- $Author: dallas $ --> -<!-- EN-Revision: 1.2 Maintainer: dallas Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: dallas Status: ready --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> - <refpurpose>¸ñʽ»¯Ò»¸ö GMT/CUT ÈÕÆÚ£¯Ê±¼ä</refpurpose> + <refpurpose>¸ñʽ»¯Ò»¸ö GMT/UTC ÈÕÆÚ£¯Ê±¼ä</refpurpose> </refnamediv> <refsect1> <title>˵Ã÷</title> Index: phpdoc-zh/reference/datetime/functions/gmstrftime.xml diff -u phpdoc-zh/reference/datetime/functions/gmstrftime.xml:1.2 phpdoc-zh/reference/datetime/functions/gmstrftime.xml:1.3 --- phpdoc-zh/reference/datetime/functions/gmstrftime.xml:1.2 Sun Sep 29 23:07:33 2002 +++ phpdoc-zh/reference/datetime/functions/gmstrftime.xml Mon Feb 24 01:38:24 2003 @@ -1,12 +1,12 @@ <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- $Author: dallas $ --> -<!-- EN-Revision: 1.3 Maintainer: dallas Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: dallas Status: ready --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose> - ¸ù¾ÝÇøÓòÉèÖøñʽ»¯ GMT/CUT ʱ¼ä£¯ÈÕÆÚ + ¸ù¾ÝÇøÓòÉèÖøñʽ»¯ GMT/UTC ʱ¼ä£¯ÈÕÆÚ </refpurpose> </refnamediv> <refsect1>
Index: phpdoc-zh/reference/datetime/functions/date.xml diff -u phpdoc-zh/reference/datetime/functions/date.xml:1.4 phpdoc-zh/reference/datetime/functions/date.xml:1.5 --- phpdoc-zh/reference/datetime/functions/date.xml:1.4 Sun Sep 29 23:07:33 2002 +++ phpdoc-zh/reference/datetime/functions/date.xml Mon Feb 24 01:38:24 2003 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- $Author: dallas $ --> -<!-- EN-Revision: 1.4 Maintainer: dallas Status: ready --> +<!-- EN-Revision: 1.7 Maintainer: dallas Status: ready --> <refentry id="function.date"> <refnamediv> <refname>date</refname> @@ -18,7 +18,8 @@ </methodsynopsis> <para> ·µ»Ø½«ÕûÊý <parameter>timestamp</parameter> - °´ÕÕ¸ø¶¨µÄ¸ñʽ×Ö´®¶ø²úÉúµÄ×Ö·û´®¡£Èç¹ûûÓиø³öʱ¼ä´ÁÔòʹÓñ¾µØµ±Ç°Ê±¼ä¡£ + °´ÕÕ¸ø¶¨µÄ¸ñʽ×Ö´®¶ø²úÉúµÄ×Ö·û´®¡£Èç¹ûûÓиø³öʱ¼ä´ÁÔòʹÓñ¾µØµ±Ç°Ê±¼ä¡£»»¾ä»°Ëµ£¬<parameter>timestamp</parameter> + ÊÇ¿ÉÑ¡µÄ£¬Ä¬ÈÏֵΪ <function>time</function>¡£ <note> <para> ÓÐЧµÄʱ¼ä´ÁµäÐÍ·¶Î§ÊǸñÁÖÍþÖÎʱ¼ä 1901 Äê 12 Ô 13 ÈÕ 20:45:54 @@ -29,182 +30,200 @@ <para> Òª½«×Ö·û´®±í´ïµÄʱ¼äת»»³Éʱ¼ä´Á£¬Ó¦¸ÃʹÓà <function>strtotime</function>¡£´ËÍâһЩÊý¾Ý¿âÓÐһЩº¯Êý½«Æäʱ¼ä¸ñʽת»»³Éʱ¼ä´Á£¨ÀýÈç - MySQL µÄ UNIX_TIMESTAMP º¯Êý£©¡£ + MySQL µÄ <ulink url="&url.mysql.docs.date;">UNIX_TIMESTAMP</ulink> º¯Êý£©¡£ </para> </note> </para> <para> - ¸ñʽ×Ö´®¿ÉÒÔʶ±ðÒÔÏÂ×Ö·û£º - <itemizedlist> - <listitem> - <simpara> - a - "am" »ò "pm" - </simpara> - </listitem> - <listitem> - <simpara> - A - "AM" »ò "PM" - </simpara> - </listitem> - <listitem> - <simpara> - B - Swatch Internet Time£¨¡¾ÒëÕß×¢¡¿²Î¼û http://swatch.com/alu_beat/fs_itime.html£© - </simpara> - </listitem> - <listitem> - <simpara> - d - Ô·ÝÖеĵڼ¸Ì죬ÓÐǰµ¼ÁãµÄ 2 λÊý×Ö£¬ÀýÈç "01" - to "31" - </simpara> - </listitem> - <listitem> - <simpara> - D - ÐÇÆÚÖеĵڼ¸Ì죬Îı¾±íʾ£¬3 ¸ö×Öĸ£¬ÀýÈç "Fri" - </simpara> - </listitem> - <listitem> - <simpara> - F - Ô·ݣ¬ÍêÕûµÄÎı¾¸ñʽ£¬ÀýÈç "January" - </simpara> - </listitem> - <listitem> - <simpara> - g - Сʱ£¬12 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Á㣬ÀýÈç "1" µ½ "12" - </simpara> - </listitem> - <listitem> - <simpara> - G - Сʱ£¬24 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Á㣬ÀýÈç "0" µ½ "23" - </simpara> - </listitem> - <listitem> - <simpara> - h - Сʱ£¬12 Сʱ¸ñʽ£¬ÀýÈç "01" µ½ "12" - </simpara> - </listitem> - <listitem> - <simpara> - H - Сʱ£¬24 Сʱ¸ñʽ£¬ÀýÈç "00" µ½ "23" - </simpara> - </listitem> - <listitem> - <simpara> - i - ·ÖÖÓ£¬ÀýÈç "00" µ½ "59" - </simpara> - </listitem> - <listitem> - <simpara> - I£¨¡°i¡±µÄ´óдµÄ×Öĸ£©- Èç¹ûÊÇÏÄÁîʱÔòΪ "1"£¬·ñÔòΪ "0" - </simpara> - </listitem> - <listitem> - <simpara> - j - Ô·ÝÖеĵڼ¸Ì죬ûÓÐǰµ¼Á㣬ÀýÈç "1" µ½ "31" - </simpara> - </listitem> - <listitem> - <simpara> - l£¨¡°L¡±µÄСд×Öĸ£©- ÐÇÆÚÖеĵڼ¸Ì죬ÍêÕûµÄÎı¾¸ñʽ£¬ÀýÈç "Friday" - </simpara> - </listitem> - <listitem> - <simpara> - L - ²¼¶ûÖµ±íʾÊÇ·ñΪÈòÄ꣬ÀýÈç "0" »òÕß "1" - </simpara> - </listitem> - <listitem> - <simpara> - m - Ô·ݣ¬ÀýÈç "01" to "12" - </simpara> - </listitem> - <listitem> - <simpara> - M - Ô·ݣ¬Îı¾±íʾ£¬3 ¸ö×Öĸ£¬ÀýÈç "Jan" - </simpara> - </listitem> - <listitem> - <simpara> - n - Ô·ݣ¬Ã»ÓÐǰµ¼Á㣬ÀýÈç "1" µ½ "12" - </simpara> - </listitem> - <listitem> - <simpara> - O - Óë¸ñÁÖÍþÖÎʱ¼äÏà²îµÄСʱÊý£¬ÀýÈç "+0200" - </simpara> - </listitem> - <listitem> - <simpara> - r - RFC 822 ¸ñʽµÄÈÕÆÚ£¬ÀýÈç "Thu, 21 Dec 2000 16:01:07 +0200"£¨PHP 4.0.4ÐÂÔö£© - </simpara> - </listitem> - <listitem> - <simpara> - s - ÃëÊý£¬ÀýÈç "00" µ½ "59" - </simpara> - </listitem> - <listitem> - <simpara> - S - ÿÔÂÌìÊýºóÃæµÄÓ¢Îĺó׺£¬2 ¸ö×Ö·û£¬ÀýÈç "st"£¬"nd"£¬"rd" »òÕß "th" - </simpara> - </listitem> - <listitem> - <simpara> - t - ¸ø¶¨Ô·ÝËùÓ¦ÓеÄÌìÊý£¬ÀýÈç "28" µ½ "31" - </simpara> - </listitem> - <listitem> - <simpara> - T - ±¾»úËùÔÚµÄÊ±Çø£¬ÀýÈç "EST" »ò "MDT"£¨¡¾ÒëÕß×¢¡¿ÔÚ Windows - ÏÂΪÍêÕûÎı¾¸ñʽ£¬ÀýÈç¡°Eastern Standard Time¡±£¬ÖÐÎİæ»áÏÔʾ¡°Öйú±ê׼ʱ¼ä¡±¡££© - </simpara> - </listitem> - <listitem> - <simpara> - U - ´Ó Unix ¼ÍÔª£¨January 1 1970 00:00:00 GMT£©¿ªÊ¼ÖÁ½ñµÄÃëÊý - </simpara> - </listitem> - <listitem> - <simpara> - w - ÐÇÆÚÖеĵڼ¸Ì죬Êý×Ö±íʾ£¬ÀýÈç "0"£¨ÐÇÆÚÌ죩µ½ "6" - (Saturday) - </simpara> - </listitem> - <listitem> - <simpara> - W - ISO-8601 ¸ñʽÄê·ÝÖеĵڼ¸ÖÜ£¬Ã¿ÖÜ´ÓÐÇÆÚÒ»¿ªÊ¼£¨PHP 4.1.0 мӵģ© - </simpara> - </listitem> - <listitem> - <simpara> - Y - Äê·Ý£¬4 λÊý×Ö£¬ÀýÈç "1999" - </simpara> - </listitem> - <listitem> - <simpara> - y - Äê·Ñ£¬2 λÊý×Ö£¬ÀýÈç "99" - </simpara> - </listitem> - <listitem> - <simpara> - z - Äê·ÝÖеĵڼ¸Ì죬ÀýÈç "0" µ½ "365" - </simpara> - </listitem> - <listitem> - <simpara> - Z - ʱ²îÆ«ÒÆÁ¿µÄÃëÊý£¨ÀýÈç "-43200" µ½ "43200"£©¡£UTC Î÷±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊǸºµÄ£¬UTC - ¶«±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊÇÕýµÄ¡£ - </simpara> - </listitem> - </itemizedlist> - ¸ñʽ×Ö´®Öв»Äܱ»Ê¶±ðµÄ×Ö·û½«ÔÑùÏÔʾ¡£¡°Z¡±¸ñʽÔÚʹÓà <function>gmdate</function> ʱ×ÜÊÇ·µ»Ø¡°0¡±¡£ + <table> + <title>¸ñʽ×Ö´®¿ÉÒÔʶ±ðÒÔÏ <parameter>format</parameter> ²ÎÊýµÄ×Ö·û´®</title> + <tgroup cols="3"> + <thead> + <row> + <entry><parameter>format</parameter> ×Ö·û</entry> + <entry>˵Ã÷</entry> + <entry>·µ»ØÖµÀý×Ó</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>a</literal></entry> + <entry>СдµÄÉÏÎçºÍÏÂÎçÖµ</entry> + <entry><literal>am</literal> »ò <literal>pm</literal></entry> + </row> + <row> + <entry><literal>A</literal></entry> + <entry>´óдµÄÉÏÎçºÍÏÂÎçÖµ</entry> + <entry><literal>AM</literal> »ò <literal>PM</literal></entry> + </row> + <row> + <entry><literal>B</literal></entry> + <entry>Swatch Internet ±ê׼ʱ</entry> + <entry><literal>000</literal> µ½ <literal>999</literal></entry> + </row> + <row> + <entry><literal>d</literal></entry> + <entry>Ô·ÝÖеĵڼ¸Ì죬ÓÐǰµ¼ÁãµÄ 2 λÊý×Ö</entry> + <entry><literal>01</literal> µ½ <literal>31</literal></entry> + </row> + <row> + <entry><literal>D</literal></entry> + <entry>ÐÇÆÚÖеĵڼ¸Ì죬Îı¾±íʾ£¬3 ¸ö×Öĸ</entry> + <entry><literal>Mon</literal> µ½ <literal>Sun</literal></entry> + </row> + <row> + <entry><literal>F</literal></entry> + <entry>Ô·ݣ¬ÍêÕûµÄÎı¾¸ñʽ£¬ÀýÈç January »òÕß March</entry> + <entry><literal>January</literal> µ½ <literal>December</literal></entry> + </row> + <row> + <entry><literal>g</literal></entry> + <entry>Сʱ£¬12 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Áã</entry> + <entry><literal>1</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>G</literal></entry> + <entry>Сʱ£¬24 Сʱ¸ñʽ£¬Ã»ÓÐǰµ¼Áã</entry> + <entry><literal>0</literal> µ½ <literal>23</literal></entry> + </row> + <row> + <entry><literal>h</literal></entry> + <entry>Сʱ£¬12 Сʱ¸ñʽ£¬ÓÐǰµ¼Áã</entry> + <entry><literal>01</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>H</literal></entry> + <entry>Сʱ£¬24 Сʱ¸ñʽ£¬ÓÐǰµ¼Áã</entry> + <entry><literal>00</literal> µ½ <literal>23</literal></entry> + </row> + <row> + <entry><literal>i</literal></entry> + <entry>ÓÐǰµ¼ÁãµÄ·ÖÖÓÊý</entry> + <entry><literal>00</literal> µ½ <literal>59</literal>></entry> + </row> + <row> + <entry><literal>I</literal></entry> + <entry>ÊÇ·ñΪÏÄÁîʱ</entry> + <entry>Èç¹ûÊÇÏÄÁîʱΪ <literal>1</literal>£¬·ñÔòΪ <literal>0</literal></entry> + </row> + <row> + <entry><literal>j</literal></entry> + <entry>Ô·ÝÖеĵڼ¸Ì죬ûÓÐǰµ¼Áã</entry> + <entry><literal>1</literal> µ½ <literal>31</literal></literal></entry> + </row> + <row> + <entry><literal>l</literal>£¨¡°L¡±µÄСд×Öĸ£©</entry> + <entry>ÐÇÆÚ¼¸£¬ÍêÕûµÄÎı¾¸ñʽ</entry> + <entry><literal>Sunday</literal> µ½ <literal>Saturday</literal></entry> + </row> + <row> + <entry><literal>L</literal></entry> + <entry>ÊÇ·ñΪÈòÄê</entry> + <entry>Èç¹ûÊÇÈòÄêΪ <literal>1</literal>£¬·ñÔòΪ <literal>0</literal></entry> + </row> + <row> + <entry><literal>m</literal></entry> + <entry>Êý×Ö±íʾµÄÔ·ݣ¬ÓÐǰµ¼Áã</entry> + <entry><literal>01</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>M</literal></entry> + <entry>Èý¸ö×ÖĸËõд±íʾµÄÔ·Ý</entry> + <entry><literal>Jan</literal> µ½ <literal>Dec</literal></entry> + </row> + <row> + <entry><literal>n</literal></entry> + <entry>Êý×Ö±íʾµÄÔ·ݣ¬Ã»ÓÐǰµ¼Áã</entry> + <entry><literal>1</literal> µ½ <literal>12</literal></entry> + </row> + <row> + <entry><literal>O</literal></entry> + <entry>Óë¸ñÁÖÍþÖÎʱ¼äÏà²îµÄСʱÊý</entry> + <entry>ÀýÈ磺<literal>+0200</literal></entry> + </row> + <row> + <entry><literal>r</literal></entry> + <entry>RFC 822 ¸ñʽµÄÈÕÆÚ</entry> + <entry>ÀýÈ磺<literal>Thu, 21 Dec 2000 16:01:07 +0200</literal></entry> + </row> + <row> + <entry><literal>s</literal></entry> + <entry>ÃëÊý£¬ÓÐǰµ¼Áã</entry> + <entry><literal>00</literal> µ½ <literal>59</literal>></entry> + </row> + <row> + <entry><literal>S</literal></entry> + <entry>ÿÔÂÌìÊýºóÃæµÄÓ¢Îĺó׺£¬2 ¸ö×Ö·û</entry> + <entry><literal>st</literal>£¬<literal>nd</literal>£¬<literal>rd</literal> »òÕß <literal>th</literal>¡£¿ÉÒÔºÍ <literal>j</literal> Ò»ÆðÓá£</entry> + </row> + <row> + <entry><literal>t</literal></entry> + <entry>¸ø¶¨Ô·ÝËùÓ¦ÓеÄÌìÊý</entry> + <entry><literal>28</literal> µ½ <literal>31</literal></entry> + </row> + <row> + <entry><literal>T</literal></entry> + <entry>±¾»úËùÔÚµÄÊ±Çø</entry> + <entry>ÀýÈ磺<literal>EST</literal>£¬<literal>MDT</literal>£¨¡¾ÒëÕß×¢¡¿ÔÚ Windows + ÏÂΪÍêÕûÎı¾¸ñʽ£¬ÀýÈç¡°Eastern Standard Time¡±£¬ÖÐÎİæ»áÏÔʾ¡°Öйú±ê׼ʱ¼ä¡±£©¡£</entry> + </row> + <row> + <entry><literal>U</literal></entry> + <entry>´Ó Unix ¼ÍÔª£¨January 1 1970 00:00:00 GMT£©¿ªÊ¼ÖÁ½ñµÄÃëÊý</entry> + <entry>²Î¼û <function>time</function></entry> + </row> + <row> + <entry><literal>w</literal></entry> + <entry>ÐÇÆÚÖеĵڼ¸Ì죬Êý×Ö±íʾ</entry> + <entry><literal>0</literal>£¨±íʾÐÇÆÚÌ죩µ½ <literal>6</literal>£¨±íʾÐÇÆÚÁù£©</entry> + </row> + <row> + <entry><literal>W</literal></entry> + <entry>ISO-8601 ¸ñʽÄê·ÝÖеĵڼ¸ÖÜ£¬Ã¿ÖÜ´ÓÐÇÆÚÒ»¿ªÊ¼£¨PHP 4.1.0 мӵģ©</entry> + <entry>ÀýÈ磺<literal>42</literal>£¨µ±ÄêµÄµÚ 42 ÖÜ£©</entry> + </row> + <row> + <entry><literal>Y</literal></entry> + <entry>4 λÊý×ÖÍêÕû±íʾµÄÄê·Ý</entry> + <entry>ÀýÈ磺<literal>1999</literal> »ò <literal>2003</literal></entry> + </row> + <row> + <entry><literal>y</literal></entry> + <entry>2 λÊý×Ö±íʾµÄÄê·Ý</entry> + <entry>ÀýÈ磺<literal>99</literal> »ò <literal>03</literal></entry> + </row> + <row> + <entry><literal>z</literal></entry> + <entry>Äê·ÝÖеĵڼ¸Ìì</entry> + <entry><literal>0</literal> µ½ <literal>366</literal></entry> + </row> + <row> + <entry><literal>Z</literal></entry> + <entry>ʱ²îÆ«ÒÆÁ¿µÄÃëÊý¡£UTC Î÷±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊǸºµÄ£¬UTC ¶«±ßµÄÊ±ÇøÆ«ÒÆÁ¿×ÜÊÇÕýµÄ¡£</entry> + <entry><literal>-43200</literal> µ½ <literal>43200</literal></entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + ¸ñʽ×Ö´®Öв»Äܱ»Ê¶±ðµÄ×Ö·û½«ÔÑùÏÔʾ¡£<literal>Z</literal> ¸ñʽÔÚʹÓà <function>gmdate</function> ʱ×ÜÊÇ·µ»Ø <literal>0</literal>¡£ </para> <para> <example> <title><function>date</function> Àý×Ó</title> <programlisting role="php"> <![CDATA[ +<?php +// Prints something like: Wednesday +echo date("l"); + +// Prints something like: Wednesday 15th of January 2003 05:51:38 AM echo date ("l dS of F Y h:i:s A"); + +// Prints: July 1, 2000 is on a Saturday echo "July 1, 2000 is on a " . date ("l", mktime(0,0,0,7,1,2000)); +?> ]]> </programlisting> </example> @@ -215,7 +234,10 @@ <title>ÔÚ <function>date</function> ÖÐתÒå×Ö·û</title> <programlisting role="php"> <![CDATA[ -echo date("l \\t\h\e jS"); // ÏÔʾÀàËÆÓÚ£ºSaturday the 8th +<?php +// prints something like: Wednesday the 15th +echo date("l \\t\h\e jS"); +?> ]]> </programlisting> </example> @@ -229,9 +251,11 @@ </title> <programlisting role="php"> <![CDATA[ +<?php $tomorrow = mktime (0,0,0,date("m") ,date("d")+1,date("Y")); $lastmonth = mktime (0,0,0,date("m")-1,date("d"), date("Y")); $nextyear = mktime (0,0,0,date("m"), date("d"), date("Y")+1); +?> ]]> </programlisting> </example> @@ -251,7 +275,8 @@ </title> <programlisting role="php"> <![CDATA[ -/* Today is March 10th, 2001, 5:16:18 pm */ +<?php +// Assuming today is: March 10th, 2001, 5:16:18 pm $today = date("F j, Y, g:i a"); // March 10, 2001, 5:16 pm $today = date("m.d.y"); // 03.10.01 $today = date("j, n, Y"); // 10, 3, 2001 @@ -261,6 +286,7 @@ $today = date("D M j G:i:s T Y"); // Sat Mar 10 15:16:08 MST 2001 $today = date('H:m:s \m \i\s\ \m\o\n\t\h'); // 17:03:17 m is month $today = date("H:i:s"); // 17:16:17 +?> ]]> </programlisting> </example> Index: phpdoc-zh/reference/datetime/functions/gmdate.xml diff -u phpdoc-zh/reference/datetime/functions/gmdate.xml:1.2 phpdoc-zh/reference/datetime/functions/gmdate.xml:1.3 --- phpdoc-zh/reference/datetime/functions/gmdate.xml:1.2 Sun Sep 29 23:07:33 2002 +++ phpdoc-zh/reference/datetime/functions/gmdate.xml Mon Feb 24 01:38:24 2003 @@ -1,11 +1,11 @@ <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- $Author: dallas $ --> -<!-- EN-Revision: 1.2 Maintainer: dallas Status: ready --> +<!-- EN-Revision: 1.3 Maintainer: dallas Status: ready --> <refentry id="function.gmdate"> <refnamediv> <refname>gmdate</refname> - <refpurpose>¸ñʽ»¯Ò»¸ö GMT/CUT ÈÕÆÚ£¯Ê±¼ä</refpurpose> + <refpurpose>¸ñʽ»¯Ò»¸ö GMT/UTC ÈÕÆÚ£¯Ê±¼ä</refpurpose> </refnamediv> <refsect1> <title>˵Ã÷</title> Index: phpdoc-zh/reference/datetime/functions/gmstrftime.xml diff -u phpdoc-zh/reference/datetime/functions/gmstrftime.xml:1.2 phpdoc-zh/reference/datetime/functions/gmstrftime.xml:1.3 --- phpdoc-zh/reference/datetime/functions/gmstrftime.xml:1.2 Sun Sep 29 23:07:33 2002 +++ phpdoc-zh/reference/datetime/functions/gmstrftime.xml Mon Feb 24 01:38:24 2003 @@ -1,12 +1,12 @@ <?xml version="1.0" encoding="gb2312"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- $Author: dallas $ --> -<!-- EN-Revision: 1.3 Maintainer: dallas Status: ready --> +<!-- EN-Revision: 1.4 Maintainer: dallas Status: ready --> <refentry id="function.gmstrftime"> <refnamediv> <refname>gmstrftime</refname> <refpurpose> - ¸ù¾ÝÇøÓòÉèÖøñʽ»¯ GMT/CUT ʱ¼ä£¯ÈÕÆÚ + ¸ù¾ÝÇøÓòÉèÖøñʽ»¯ GMT/UTC ʱ¼ä£¯ÈÕÆÚ </refpurpose> </refnamediv> <refsect1>