   #PHP Manual Date and Time functions mktime strtotime

   PHP Manual
   Prev  Next
   ______________________________________________________________________

                                   strftime

   (PHP 3, PHP 4 )
   strftime --  Format a local time/date according to locale settings

Description

   string strftime ( string format [, int timestamp])

   Returns a string formatted according to the given format string using
   the given timestamp or the current local time if no timestamp is
   given. Month and weekday names and other language dependent strings
   respect the current locale set with setlocale().

   The following conversion specifiers are recognized in the format
   string:

     * %a - abbreviated weekday name according to the current locale
     * %A - full weekday name according to the current locale
     * %b - abbreviated month name according to the current locale
     * %B - full month name according to the current locale
     * %c - preferred date and time representation for the current locale
     * %C - century number (the year divided by 100 and truncated to an
       integer, range 00 to 99)
     * %d - day of the month as a decimal number (range 01 to 31)
     * %D - same as %m/%d/%y
     * %e - day of the month as a decimal number, a single digit is
       preceded by a space (range ' 1' to '31')
     * %g - like %G, but without the century.
     * %G - The 4-digit year corresponding to the ISO week number (see
       %V). This has the same format and value as %Y, except that if the
       ISO week number belongs to the previous or next year, that year is
       used instead.
     * %h - same as %b
     * %H - hour as a decimal number using a 24-hour clock (range 00 to
       23)
     * %I - hour as a decimal number using a 12-hour clock (range 01 to
       12)
     * %j - day of the year as a decimal number (range 001 to 366)
     * %m - month as a decimal number (range 01 to 12)
     * %M - minute as a decimal number
     * %n - newline character
     * %p - either `am' or `pm' according to the given time value, or the
       corresponding strings for the current locale
     * %r - time in a.m. and p.m. notation
     * %R - time in 24 hour notation
     * %S - second as a decimal number
     * %t - tab character
     * %T - current time, equal to %H:%M:%S
     * %u - weekday as a decimal number [1,7], with 1 representing Monday

                                    Warning
   Sun Solaris seems to start with Sunday as 1 although ISO 9889:1999
   (the current C standard) clearly specifies that it should be Monday.
     * %U - week number of the current year as a decimal number, starting
       with the first Sunday as the first day of the first week
     * %V - The ISO 8601:1988 week number of the current year as a
       decimal number, range 01 to 53, where week 1 is the first week
       that has at least 4 days in the current year, and with Monday as
       the first day of the week. (Use %G or %g for the year component
       that corresponds to the week number for the specified timestamp.)
     * %W - week number of the current year as a decimal number, starting
       with the first Monday as the first day of the first week
     * %w - day of the week as a decimal, Sunday being 0
     * %x - preferred date representation for the current locale without
       the time
     * %X - preferred time representation for the current locale without
       the date
     * %y - year as a decimal number without a century (range 00 to 99)
     * %Y - year as a decimal number including the century
     * %Z - time zone or name or abbreviation
     * %% - a literal `%' character

     Note: Not all conversion specifiers may be supported by your C
     library, in which case they will not be supported by PHP's
     strftime(). Additionally, not all platforms support negative
     timestamps, therefore your date range may be limited to no earlier
     than the Unix epoch. This means that e.g. %e, %T, %R and %D (there
     might be more) and dates prior to Jan 1, 1970 will not work on
     Windows, some Linux distributions, and a few other operating
     systems. For Windows systems a complete overview of supported
     conversion specifiers can be found at this MSDN website.

   Example 1. strftime() locale examples
   <?php
   setlocale(LC_TIME, "C");
   echo strftime("%A");
   setlocale(LC_TIME, "fi_FI");
   echo strftime(" in Finnish is %A,");
   setlocale(LC_TIME, "fr_FR");
   echo strftime(" in French %A and");
   setlocale(LC_TIME, "de_DE");
   echo strftime(" in German %A.\n");
   ?>
   This example works if you have the respective locales installed in
   your system.

     Note: %G and %V, which are based on ISO 8601:1988 week numbers can
     give unexpected (albeit correct) results if the numbering system is
     not thoroughly understood. See %V above and example below.

   Example 2. ISO 8601:1988 week number example
   <?php
   /*     December 2002 / January 2003
   ISOWk  M   Tu  W   Thu F   Sa  Su
   ----- ----------------------------
   51     16  17  18  19  20  21  22
   52     23  24  25  26  27  28  29
   1      30  31   1   2   3   4   5
   2       6   7   8   9  10  11  12
   3      13  14  15  16  17  18  19   */
   // Outputs: 12/28/2002 - %V,%G,%Y = 52,2002,2002
   echo "12/28/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",
   strtotime("12/28/2002")) . "\n";
   // Outputs: 12/30/2002 - %V,%G,%Y = 1,2003,2002
   echo "12/30/2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",
   strtotime("12/30/2002")) . "\n";
   // Outputs: 1/3/2003 - %V,%G,%Y = 1,2003,2003
   echo "1/3/2003 - %V,%G,%Y = " .
   strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";
   // Outputs: 1/10/2003 - %V,%G,%Y = 2,2003,2003
   echo "1/10/2003 - %V,%G,%Y = " .
   strftime("%V,%G,%Y",strtotime("1/10/2003")) . "\n";
   /*     December 2004 / January 2005
   ISOWk  M   Tu  W   Thu F   Sa  Su
   ----- ----------------------------
   51     13  14  15  16  17  18  19
   52     20  21  22  23  24  25  26
   53     27  28  29  30  31   1   2
   1       3   4   5   6   7   8   9
   2      10  11  12  13  14  15  16   */
   // Outputs: 12/23/2004 - %V,%G,%Y = 52,2004,2004
   echo "12/23/2004 - %V,%G,%Y = " .
   strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";
   // Outputs: 12/31/2004 - %V,%G,%Y = 53,2004,2004
   echo "12/31/2004 - %V,%G,%Y = " .
   strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";
   // Outputs: 1/2/2005 - %V,%G,%Y = 53,2004,2005
   echo "1/2/2005 - %V,%G,%Y = " .
   strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";
   // Outputs: 1/3/2005 - %V,%G,%Y = 1,2005,2005
   echo "1/3/2005 - %V,%G,%Y = " .
   strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";
   ?>

   See also setlocale(), mktime(), and the Open Group specification of
   strftime().
   ______________________________________________________________________

   Prev   Home      Next
   mktime  Up  strtotime
