Index: phpdoc/en/reference/datetime/functions/date.xml diff -u phpdoc/en/reference/datetime/functions/date.xml:1.4 phpdoc/en/reference/datetime/functions/date.xml:1.5 --- phpdoc/en/reference/datetime/functions/date.xml:1.4 Fri May 24 14:59:02 2002 +++ phpdoc/en/reference/datetime/functions/date.xml Wed Jan 15 05:03:34 2003 @@ -1,5 +1,5 @@ - + @@ -18,7 +18,8 @@ Returns a string formatted according to the given format string using the given integer timestamp or the current local time - if no timestamp is given. + if no timestamp is given. In otherwords, timestamp + is optional and defaults to the value of time. The valid range of a timestamp is typically from Fri, 13 Dec @@ -31,189 +32,207 @@ To generate a timestamp from a string representation of the date, you may be able to use strtotime. Additionally, some databases have functions to convert their date formats into timestamps - (such as MySQL's UNIX_TIMESTAMP function). + (such as MySQL's UNIX_TIMESTAMP + function). - The following characters are recognized in the format string: - - - - a - "am" or "pm" - - - - - A - "AM" or "PM" - - - - - B - Swatch Internet time - - - - - d - day of the month, 2 digits with leading zeros; i.e. "01" - to "31" - - - - - D - day of the week, textual, 3 letters; e.g. "Fri" - - - - - F - month, textual, long; e.g. "January" - - - - - g - hour, 12-hour format without leading zeros; i.e. "1" to - "12" - - - - - G - hour, 24-hour format without leading zeros; i.e. "0" to - "23" - - - - - h - hour, 12-hour format; i.e. "01" to "12" - - - - - H - hour, 24-hour format; i.e. "00" to "23" - - - - - i - minutes; i.e. "00" to "59" - - - - - I (capital i) - "1" if Daylight Savings Time, "0" otherwise. - - - - - j - day of the month without leading zeros; i.e. "1" to "31" - - - - - l (lowercase 'L') - day of the week, textual, long; - e.g. "Friday" - - - - - L - boolean for whether it is a leap year; i.e. "0" or "1" - - - - - m - month; i.e. "01" to "12" - - - - - M - month, textual, 3 letters; e.g. "Jan" - - - - - n - month without leading zeros; i.e. "1" to "12" - - - - - O - Difference to Greenwich time in hours; e.g. "+0200" - - - - - r - RFC 822 formatted date; e.g. "Thu, 21 Dec 2000 16:01:07 +0200" - (added in PHP 4.0.4) - - - - - s - seconds; i.e. "00" to "59" - - - - - S - English ordinal suffix for the day of the month, 2 characters; - i.e. "st", "nd", "rd" or "th" - - - - - t - number of days in the given month; i.e. "28" to "31" - - - - - T - Timezone setting of this machine; e.g. "EST" or "MDT" - - - - - U - seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) - - - - - w - day of the week, numeric, i.e. "0" (Sunday) to "6" - (Saturday) - - - - - W - ISO-8601 week number of year, weeks starting on Monday (added in PHP 4.1.0) - - - - - Y - year, 4 digits; e.g. "1999" - - - - - y - year, 2 digits; e.g. "99" - - - - - z - day of the year; i.e. "0" to "365" - - - - - Z - timezone offset in seconds (i.e. "-43200" to "43200"). The - offset for timezones west of UTC is always negative, and for - those east of UTC is always positive. - - - +

+ The following characters are recognized in the + <parameter>format</parameter> parameter string + + + + format character + Description + Example returned values + + + + + a + Lowercase Ante meridiem and Post meridiem + am or pm + + + A + Uppercase Ante meridiem and Post meridiem + AM or PM + + + B + Swatch Internet time + 000 through 999 + + + d + Day of the month, 2 digits with leading zeros + 01 to 31 + + + D + A textual representation of a week, three letters + Mon through Sun + + + F + A full textual representation of a month, such as January or March + January through December + + + g + 12-hour format of an hour without leading zeros + 1 through 12 + + + G + 24-hour format of an hour without leading zeros + 0 through 23 + + + h + 12-hour format of an hour with leading zeros + 01 through 12 + + + H + 24-hour format of an hour with leading zeros + 00 through 23 + + + i + Minutes with leading zeros + 00 to 59 + + + I (capital i) + Whether or not the date is in daylights savings time + 1 if Daylight Savings Time, 0 otherwise. + + + j + Day of the month without leading zeros + 1 to 31 + + + l (lowercase 'L') + A full textual representation of the day of the week + Sunday through Saturday + + + L + Whether it's a leap year + 1 if it is a leap year, 0 otherwise. + + + m + Numeric representation of a month, with leading zeros + 01 through 12 + + + M + A short textual representation of a month, three letters + Jan through Dec + + + n + Numeric representation of a month, without leading zeros + 1 through 12 + + + O + Difference to Greenwich time (GMT) in hours + Example: +0200 + + + r + RFC 822 formatted date + Example: Thu, 21 Dec 2000 16:01:07 +0200 + + + s + Seconds, with leading zeros + 00 through 59 + + + S + English ordinal suffix for the day of the month, 2 characters + + st, nd, rd or + th. Works well with j + + + + t + Number of days in the given month + 28 through 31 + + + T + Timezone setting of this machine + Examples: EST, MDT ... + + + U + Seconds since the Unix Epoch (January 1 1970 00:00:00 GMT) + See also time + + + w + Numeric representation of the day of the week + 0 (for Sunday) through 6 (for Saturday) + + + W + ISO-8601 week number of year, weeks starting on Monday (added in PHP 4.1.0) + Example: 42 (the 42nd week in the year) + + + Y + A full numeric representation of a year, 4 digits + Examples: 1999 or 2003 + + + y + A two digit representation of a year + Examples: 99 or 03 + + + z + The day of the year + 0 through 366 + + + Z + Timezone offset in seconds. The offset for timezones west of UTC is always + negative, and for those east of UTC is always positive. + -43200 through 43200 + + + +
+ + Unrecognized characters in the format string will be printed - as-is. The "Z" format will always return "0" when using - gmdate. + as-is. The Z format will always return + 0 when using gmdate. - <function>date</function> example + <function>date</function> examples ]]> @@ -227,7 +246,10 @@ Escaping characters in <function>date</function> ]]> @@ -243,9 +265,11 @@ ]]> @@ -270,7 +294,9 @@ ]]>