PHP
downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

strptime> <mktime
Last updated: Sat, 24 Mar 2007

view this page in

strftime

(PHP 4, PHP 5)

strftime — Formátuje místní čas/datum s ohledem na nastavení národních specifik

Popis

string strftime ( string $format [, int $ timestamp ] )

Vrací řetězec formátovaný podle daného formátovacího řetězce, s použitím daného časového razítka timestamp, nebo aktuálního místního času, není-li razítko dáno. Název měsíce, dne v týdnu a další jazykově závislé řetězce respektují národní specifika nastavená pomocí setlocale().

Ve formátovacím řetězci se rozlišují tyto konverzní specifikátory:

  • %a - zkrácený název dne v týdnu (podle národního nastavení)
  • %A - úplný název dne v týdnu (podle národního nastavení)
  • %b - zkrácený název měsíce (podle národního nastavení)
  • %B - úplný název měsíce (podle národního nastavení)
  • %c - reprezentace času a data preferovaná aktuálním národním nastavením
  • %C - číslo století (rok dělený 100 a zkrácený na celé číslo, od 00 do 99)
  • %d - den v měsíci jako desítkové číslo (01 až 31)
  • %D - totéž jako %m/%d/%y
  • %e - den v měsíci jako desítkové číslo, jedné samotné číslici (čísla 1 až 9) předchází mezera (' 1' až '31')
  • %g - jako %G, ale bez století
  • %G - čtyřčíslicově reprezentovaný rok odpovídající týdnu podle ISO (viz %V). Má tentýž formát a hodnotu jako %Y, kromě toho, že pokud číslo týdne podle ISO patří předchozímu nebo následujícímu roku, bude tento odlišný rok použit.
  • %h - totéž jako %b
  • %H - hodina jako desítkové číslo ve 24-hodinovém formátu (00 až 23)
  • %I - hodina jako desítkové číslo ve 12-hodinovém formátu (01 až 12)
  • %j - den v roce jako desítkové číslo (001 až 366)
  • %m - měsíc jako desítkové číslo (01 až 12)
  • %M - minuta jako desítkové číslo
  • %n - znak odřádkování
  • %p - `am' nebo `pm' v závislosti na hodnotě času, resp. odpovídající řetězec podle národního nastavení
  • %r - čas v notaci a.m. a p.m. (12-hodinové)
  • %R - čas ve 24-hodinové notaci
  • %S - sekunda jako desítkové číslo
  • %t - znak tabulátoru
  • %T - aktuální čas, totéž jako %H:%M:%S
  • %u - den v týdnu jako desítkové číslo [1,7], 1 reprezentuje pondělí

    Varování

    Na počítačích Sun Solaris se vyskytuje neděle jako první den v týdnu, přestože ISO 9889:1999 (aktuální C standard) jasně specifikuje, že by to mělo být pondělí.

  • %U - týden v aktuálním roce jako desítkové číslo, počínaje první nedělí jako prvním dnem prvního týdne
  • %V - týden v aktuálním roce podle ISO 8601:1988 jako desítkové číslo, v rozsahu od 01 do 53, kde 1 je první týden s alespoň 4 dny v tomto roce, a s pondělkem jako prvním dnem v týdnu. (Odpovídající rok lze získat pomocí %G nebo %g.)
  • %W - týden v aktuálním roce jako desítkové číslo, počínaje prvním pondělkem jako prvním dnem prvního týdne
  • %w - den v týdnu jako desítkové číslo, neděle odpovídá 0
  • %x - preferovaná reprezentace data (bez času) pro aktuální národní nastavení
  • %X - preferovaná reprezentace času (bez data) pro aktuální národní nastavení
  • %y - rok jako desítkové číslo bez století (00 až 99)
  • %Y - rok jako desítkové číslo včetně století
  • %Z - časová zóna, její název nebo zkratka
  • %% - znak `%' (procento)

Poznámka: Všechny konverzní specifikátory nemusí být podporovány vaší C knihovnou, potom nebudou podporovány ani funkcí strftime() v PHP. Kromě toho také ne všechny platformy podporují práci s negativními časovými značkami, takže rozsah možných datumů může být omezen začátkem éry Unixu. To znamená, že např. %e, %T, %R a %D (a případně i další) a datumy předcházející 1.1.1970 nebudou fungovat pod Windows, některými distribucemi Linuxu a několika dalšími operačními systémy. Pro Windows lze kompletní přehled podporovaných konverzních specifikátorů najít na » webových stránkách MSDN.

Příklad 337. strftime() - místní příklady

<?php
setlocale
(LC_TIME, "C");
echo
strftime("%A");
setlocale(LC_TIME, "fi_FI");
echo
strftime(" je ve finštině %A,");
setlocale(LC_TIME, "fr_FR");
echo
strftime(" ve francouzštině %A a");
setlocale(LC_TIME, "de_DE");
echo
strftime(" v němčině %A.\n");
?>

Tento příklad bude fungovat jen tehdy, máte-li daná národní specifika nainstalována v systému.

Poznámka: %G a %V, které jsou založeny na normě ISO 8601:1988, mohou vrátit neočekávané (a přesto správné) výsledky, pokud nemáte v číslovacím systému zcela jasno. Viz %V výše a příklad níže.

Příklad 338. Příklad čísel týdnů podle ISO 8601:1988

<?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   */

// Vypíše: 28.12.2002 - %V,%G,%Y = 52,2002,2002
echo "28.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/28/2002")) . "\n";

// Vypíše: 30.12.2002 - %V,%G,%Y = 1,2003,2002
echo "30.12.2002 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/30/2002")) . "\n";

// Vypíše: 3.1.2003 - %V,%G,%Y = 1,2003,2003
echo "3.1.2003 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2003")) . "\n";

// Vypíše: 10.1.2003 - %V,%G,%Y = 2,2003,2003
echo "10.1.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   */

// Vypíše: 23.12.2004 - %V,%G,%Y = 52,2004,2004
echo "23.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/23/2004")) . "\n";

// Vypíše: 31.12.2004 - %V,%G,%Y = 53,2004,2004
echo "31.12.2004 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("12/31/2004")) . "\n";

// Vypíše: 2.1.2005 - %V,%G,%Y = 53,2004,2005
echo "2.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/2/2005")) . "\n";

// Vypíše: 3.1.2005 - %V,%G,%Y = 1,2005,2005
echo "3.1.2005 - %V,%G,%Y = " . strftime("%V,%G,%Y",strtotime("1/3/2005")) . "\n";

?>

Viz také setlocale(), mktime() a » specifikaci Open Group strftime().



strptime> <mktime
Last updated: Sat, 24 Mar 2007
 
add a note add a note User Contributed Notes
strftime
jjarsater at gmail dot com
20-May-2009 04:01
<?php
// Date string
$timestamp     =     strftime("%Y-%m-%d %H:%M:%S %Y");

// From this string ($timestamp) can we print
echo strftime("%a %d %b %H:%M:%S %Y", strtotime($timestamp))."<br/>";
echo
strftime("%a %d %b %H:%M", strtotime($timestamp))."<br/>";
echo
strftime("%Y-%m-%d %H:%M:%S", strtotime($timestamp))."<br/>";
echo
strftime("%Y-%m-%d %H:%M", strtotime($timestamp))."<br/>";
echo
strftime("%Y-%m-%d", strtotime($timestamp))."<br/>";
echo
strftime("%a %d %b %Y", strtotime($timestamp))."<br/>";

/*And it will output

Wed 20 May 15:53:40 2009
Wed 20 May 15:53
2009-05-20 15:53:40
2009-05-20 15:53
2009-05-20
Wed 20 May 2009

*/
?>
Michael Z.
19-May-2009 12:12
This is so simple it has to be found in one of all the comments on all those different time functions. But since I didn't find it, here it is: Use this to convert between different time formats:

<?PHP
if (!function_exists('convertTime')) {
 
/** Converts time strings from one format into another using
   *  PHP formats.
   *
   *  @param String $dformat Format to convert to
   *  @param String $sformat Format to convert from, e.g. format
   *      of $ts
   *  @param String $ts Time string to be converted
   *  @return String Supplied time translated to the format specified
   *    in $dformat
   */
 
function convertTime($dformat,$sformat,$ts) {
   
extract(strptime($ts,$sformat));
    return
strftime($dformat,mktime(
                                 
intval($tm_hour),
                                 
intval($tm_min),
                                 
intval($tm_sec),
                                 
intval($tm_mon)+1,
                                 
intval($tm_mday),
                                 
intval($tm_year)+1900
                               
));
  }
}

/*
 * And for the test....
 */
echo convertTime('%Y-%m-%d','%d.%m.%Y','27.11.2009');
?>

This should print "2009-27-11".

I did not put much effort in this code. The task also seems "too simple to be neccessary". But as I said, I didn't find anything to help me with this.

Cheers,

Michael Z
dapikk[at]gmail[dot]com
16-Mar-2009 11:21
I had a need to subtrackt an older time from current time to get the time between.
Example: If one has worked from 2009-03-16 11:33:54 to 2009-03-16 12:01:54 then he has worked X hours,minutes and seconds. I tried to find that X. And so - one solution would be:
<?php
$start_date
= strtotime("2009-03-16 11:33:54"); //start date from database - date("Y-m-d H:i:s") made as UNIX timestamp
$end_date = strtotime("2009-03-16 12:01:54"); //end date from database - date("Y-m-d H:i:s") made as UNIX timestamp
$ajavahe = $end_date - $start_date;
$time_between = gmstrftime('%Hh %Mm %Ss', $ajavahe); //gmstrftime() deals with different timezones correctly. (If in example you would be situated in Estonia and you would use strftime() you get wrong answer off by 2 hrs, because timezone is GMT+2 - with gmstrftime() comes right answer.)

echo 'You have worked: '.$time_between;
?>
Hope that this one makes someones life easier :D
lamb dot dan at gmail dot com
04-Dec-2008 07:37
<?php
/*
*    This function figures out what fiscal year a specified date is in.
*    $inputDate - the date you wish to find the fiscal year for. (12/4/08)
*    $fyStartDate - the month and day your fiscal year starts. (7/1)
*    $fyEndDate - the month and day your fiscal year ends. (6/30)
*    $fy - returns the correct fiscal year
*/
function calculateFiscalYearForDate($inputDate, $fyStart, $fyEnd){
   
$date = strtotime($inputDate);
   
$inputyear = strftime('%Y',$date);
       
   
$fystartdate = strtotime($fyStart.$inputyear);
   
$fyenddate = strtotime($fyEnd.$inputyear);

    if(
$date < $fyenddate){
       
$fy = intval($inputyear);
    }else{
       
$fy = intval(intval($inputyear) + 1);
    }
   
    return
$fy;
   
}

// my fiscal year starts on July,1 and ends on June 30, so...
echo calculateFiscalYearForDate("5/15/08","7/1","6/30");
// returns 2008

echo calculateFiscalYearForDate("12/1/08","7/1","6/30");
// returns 2009
?>
khaled dot ataia at gmail dot com
05-Nov-2008 03:24
for Arabic

<?php
setlocale
(LC_ALL,'ar');
echo
strftime('%A %d %B %Y');
?>
eljaunis at gmail dot com
23-Oct-2008 12:33
This is what worked in my case:

<?php
    setlocale
(LC_ALL, 'es_ES').': ';
    echo
iconv('ISO-8859-1', 'UTF-8', strftime('%A %d de %B de %Y', time()));
   
?>

it displays: miércoles 22 de octubre de 2008
buana95 at yahoo dot com
21-Aug-2008 05:51
For windows user:

If you unsuccessfully change date/time format to your locale country using xx_XX format, try using XXX format or ISO-639 country codes format.

See complete list for ISO-639 here: http://www.w3.org/WAI/ER/IG/ert/iso639.htm

For example:

<?php
setlocale
(LC_ALL, 'IND');
echo
strftime("Today in Indonesia is %A");
?>
Josue R.
09-Mar-2008 04:36
Here's a simple version for date formating i use between displaying in HTML and converting back to MYSQL format:

<?php
function format_date($original='', $format="%m/%d/%Y") {
   
$format = ($format=='date' ? "%m-%d-%Y" : $format);
   
$format = ($format=='datetime' ? "%m-%d-%Y %H:%M:%S" : $format);
   
$format = ($format=='mysql-date' ? "%Y-%m-%d" : $format);
   
$format = ($format=='mysql-datetime' ? "%Y-%m-%d %H:%M:%S" : $format);
    return (!empty(
$original) ? strftime($format, strtotime($original)) : "" );
}
?>

example (in HTML or webapp):
[grab from database]...
$dbase_stored_date = "2007-03-15";
$display_html_date = format_date($dbase_stored_date);
... displays as "03/15/2007"

example (saving form via on POST/GET):
$update_date = format_date($_POST['display_html_date'], 'mysql-date');
// converts back to '2007-03-15'
.... [your mysql update here]

Don't forget to sanitize your POST/GET's   =)
jerome dot place at free dot fr
07-Nov-2007 09:55
Here is a function to convert dates before 1970, very useful if you are still using php 4 (it is supported in php5) :

<?php
# convert a date to special format
# $date is like 2000-01-01 00:00:00
# $format : refer to strftime function
function convert_date($date,$format) {   
    if(
$date=='0000-00-00 00:00:00' OR $date=='0000-00-00' OR $date=='' OR $date==NULL) {
        return
'';
    }
    else {
       
$year=substr($date,0,4);
        if(
phpversion() < 5.0 AND $year < 1970) {
           
           
$new_date=substr_replace($date,'1980',0,4); # we replace the year by a year after 1970       
           
$new_format=eregi_replace('%a|%A|%u','',$format); # we remove days information from the format because they would be wrong
           
$new_date=strftime($new_format,strtotime($new_date)); # we convert the date
           
$new_date=eregi_replace('1980',$year,$new_date); # we put back the real year
           
return $new_date;
        }
        else {
            return
strftime($format,strtotime($date));
        }
    }
}
?>
nielsvan den berge at hotmail dot com
31-Aug-2007 03:43
A small function to get the first weekday of the month.
For example the first monday of the month, or the first friday, etc.

<?php 
 
/**
   *
   *  Gets the first weekday of that month and year
   *
   *  @param  int   The day of the week (0 = sunday, 1 = monday ... , 6 = saturday)
   *  @param  int   The month (if false use the current month)
   *  @param  int   The year (if false use the current year)
   *
   *  @return int   The timestamp of the first day of that month
   *
   **/ 
 
function get_first_day($day_number=1, $month=false, $year=false)
  {
   
$month  = ($month === false) ? strftime("%m"): $month;
   
$year   = ($year === false) ? strftime("%Y"): $year;
   
   
$first_day = 1 + ((7+$day_number - strftime("%w", mktime(0,0,0,$month, 1, $year)))%7);
 
    return
mktime(0,0,0,$month, $first_day, $year);
  }

// this will output the first wednesday of january 2007 (wed 03-01-2007)
echo strftime("%a %d-%m-%Y", get_first_day(3, 1, 2007));
?>
ma
28-Aug-2007 02:58
note, that for some languages you MUST set LC_ALL instead of LC_TIME.

note that you further have to explicitly define your output-encoding (default is ISO-8859-1 [which makes problems for some languages])!

at least i expirienced this behaviour on a german WinXP-PHP4 environment:

<?php

// does not work - gives question marks:
setlocale(LC_TIME, 'RUS'); // ISO Alpha-3 is supported by xp
echo strftime('%A', time());

?>

<?php

// DOES work:
header('Content-Type: text/html; charset=UTF-8'); // you could also use another charset here if iconv isn't installed on your system.

echo setlocale(LC_ALL, 'RUS').': ';
echo
iconv('windows-1251', 'UTF-8', strftime('%A', time()))."\n";

?>
ben dot holland at thirdlight dot com
21-Jun-2007 02:03
This little function allows you to provide a reasonably human readable string and convert to a timestamp - see example in comments below.

I find it far more useful than having to remember all the '%' modifiers. Am also well aware of its failings but it works in a lot of the real life situations I've come across.

<?php
function AmazingStringFromTime($str, $nTimestamp = null)
{
   
// This function reads a human readable string representation of dates. e.g.
    // DD MM YYYY => 01 07 1978
    // DDD D MMM YY => Mon 1 Jul 78
   
   
$arrPairs = array(
   
"DDDD"  => "%A",
   
"DDD"   => "%a",
   
"DD"    => "%d",
   
"D"     => "%e", // has leading space: ' 1', ' 2', etc for single digit days
   
"MMMM"  => "%B",
   
"MMM"   => "%b",
   
"MM"    => "%m",
   
"YYYY"  => "%Y",
   
"YY"    => "%y",
   
"HH"    => "%H",
   
"hh"    => "%I",
   
"mm"    => "%M",
   
"ss"    => "%S",
    );
   
   
$str = str_replace(array_keys($arrPairs), array_values($arrPairs), $str);
    return
strftime($str, $nTimestamp);
}
?>
th1nk3r at gmail dot DELETETHIS dot com
20-Jan-2007 06:35
Function strftime() use the locales installed in your system (linux).

If you are like me and only leave in the system the locales you use normally (en_US and your own language locale, like es_ES), you'll only be able to use the locales installed. If your application is translated to other languages, you need these locales too.

The name of the locale in your system is important too. This can be a problem when you want to distribute the app.

If you have this locales in your system:
en_US/ISO-8859-1
en_US.UTF-8/UTF-8
es_ES/ISO-8859-1
es_ES@euro/ISO-8859-15
es_ES.UTF-8/UTF-8
es_ES@euro/UTF-8

and use setlocale('es_ES'), the result will use the iso-8859-1 charset even if you have all your system, files and configuration options in UTF-8. To receive content in UTF-8, in this example, you need to use setlocale('es_ES.UTF-8') or setlocale('es_ES.UTF-8@UTF-8').

The definition of locales can change from one system to another, and so the charset from the results.
denis at spiralsolutions dot com
02-Nov-2006 09:07
(in addition to Andy's post)
To get a RFC 2822 date (used in RSS) of the current local time :

echo strftime ("%a, %d %b %Y %H:%M:%S %z") ;

Note: option %z / %Z - work different on Windows platform, for example
output of this code line can be:
Thu, 02 Nov 2006 09:54:59 Jerusalem Standard Time (on Windows)
Thu, 02 Nov 2006 09:54:59 +0200                   (on Linux)

[red. It is much smarter to use date(DATE_RSS); here]
Jon Keating
18-Jan-2006 02:49
Under windows if you are using Japanese version, you must use the following code:

setlocale(LC_ALL, "Japanese_Japan.20932") for EUC
setlocale(LC_ALL, "Japanese_Japan.932") for SJIS

I found the following page that helped me with this issue:
http://moodle.org/mod/forum/discuss.php?d=8329
jw at jwscripts dot com
29-May-2005 03:32
The following function implements the conversion specifiers which are not supported on Win32 platforms:

(Note: the specifiers %V, %G and %g can be implemented using other functions described in this section)

<?php

function strftime_win32($format, $ts = null) {
    if (!
$ts) $ts = time();

   
$mapping = array(
       
'%C' => sprintf("%02d", date("Y", $ts) / 100),
       
'%D' => '%m/%d/%y',
       
'%e' => sprintf("%' 2d", date("j", $ts)),
       
'%h' => '%b',
       
'%n' => "\n",
       
'%r' => date("h:i:s", $ts) . " %p",
       
'%R' => date("H:i", $ts),
       
'%t' => "\t",
       
'%T' => '%H:%M:%S',
       
'%u' => ($w = date("w", $ts)) ? $w : 7
   
);
   
$format = str_replace(
       
array_keys($mapping),
       
array_values($mapping),
       
$format
   
);

    return
strftime($format, $ts);
}

?>
neo at gothic-chat d0t de
25-Jun-2004 08:27
To get a RFC 850 date (used in HTTP) of the current time:

gmstrftime ("%A %d-%b-%y %T %Z", time ());

This will get for example:
Friday 25-Jun-04 03:30:23 GMT

Please note that times in HTTP-headers _must_ be GMT, so use gmstrftime() instead of strftime().
vminarik at ips-ag dot cz
10-Sep-2001 03:02
Note that setting LC_TIME is not enough for some locales under Windows, e.g. Czech, because there are some characters not contained in default (US) character set like '�' (c with hook), '�' (r with hook).


If you run Apache as regular application and have set your locale to Czech (ControlPanel/RegionalOptions), there is no problem and 'September' is correctly translated as 'z���', 'Thursday' as '�tvrtek'.
But if you run Apache as service, you get 'z�r�', and 'ctvrtek'.
To get things work as you expect you must set LC_CTYPE beside LC_TIME, or set LC_ALL.

<?php
  $locale
= 'Czech_Czech.1250';
 
$res = setlocale( 'LC_CTYPE', $locale); //important
 
$res = setlocale( 'LC_TIME', $locale);
  echo
strftime( '%A %m. %B %Y', mktime( 0,0,0,9,6,2001));
?>
zmajeed at cup dot hp dot com
23-Jul-1999 12:14
Locale names are OS dependent. HP-UX 11.0, for example, has three
German locales, de_DE.roman8, de_DE.iso88591, and
de_DE.iso885915@euro.
The command locale -a will display all available locales on a system.

So on HP-UX, to get German dates:

<?php
setlocale
("LC_TIME", "de_DE.roman8");
print(
strftime("%A\n"));
?>

strptime> <mktime
Last updated: Sat, 24 Mar 2007
 
 
show source | credits | sitemap | contact | advertising | mirror sites