strptime

mktime

Last updated: Sun, 25 Nov 2007

strftime

(PHP 4, PHP 5)

strftime — Formatteer een local time/date volgens de locale settings

Beschrijving

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

Retourneert een string geformatteerd volgens de gegeven format string gebruikmakend van de gegeven timestamp of de huidige lokale tijd als de timestamp niet is gegeven. Maand- en weeknamen en andere taalafhankelijke strings respecteren de huidige locale die is ingesteld met setlocale().

De volgende conversie specifiers worden herkend in de format string:

%a - afgekorte weekdag naam volgens de huidige locale
%A - volledige weekdag naam volgens de huidige locale
%b - afgekorte maand naam volgens de huidige locale
%B - volledige maand naam volgens de huidige locale
%c - geprefereerde date en time representatie voor de huidige locale
%C - eeuw nummer (het jaar gedeeld door 100 en geconverteerd naar integer, range 00 tot 99)
%d - dag van de maand als een decimaal nummer (range 01 tot 31)
%D - hetzelfde als %m/%d/%y
%e - dag van de maand als decimal number, een enkel cijfer wordt voorafgegaan door een space (range ' 1' tot '31')
%g - zoals %G, maar zonder de eeuw.
%G - Het viercijferige jaar dat correspondeert met het ISO week nummer. Dit heeft hetzelfde formaat en waarde als %Y, alleen als het ISO week nummer tot het vorige of volgende jaar behoort, wordt dat jaar in plaats ervan gebruikt.
%h - hetzelfde als %b
%H - uur als een decimaal nummer gebruikmakend van een 24 uurs klok %(range 00 tot 23)
%I - uur als decimaal nummer gebruikmakend van een 12 uur klok (range %01 tot 12)
%j - dag van het jaar als een decimaal nummer (range 001 tot 366)
%m - maand als decimaal nummer (range 01 tot 12)
%M - minuut als decimaal nummer
%n - newline karakter
%p - `am' of `pm' volgens de gegeven time waarde, of de corresponderende strings voor de huidige locale.
%r - time in a.m. en p.m. notatie
%R - time in 24 uur notatie
%S - seconde als decimaal nummer
%t - tab karakter
%T - huidige tijd, hetzelfde als %H:%M:%S
%u - weekdag als een decimaal nummer [1,7], waar 1 de maandag representeert.
Warning
Sun Solaris lijkt te beginnen met zondag als 1, hoewel ISO 9889:1999 (de huidige C standaard) duidelijk aangeeft dat het maandag moet zijn.
%U - week nummer van het huidige jaar als een decimaal nummer, startend met de eerste zondag als de eerste dag van de eerste week
%V - Het ISO 8601:1988 week nummer van het huidige jaar als een decimaal nummer, range 01 tot 53, waar week 1 de eerste week is die tenminste 4 dagen in het huidige jaar heeft, en met maandag als de eerste dag van de week. (Je kunt %G of %g of gebruiken om het jaar te achterhalen dat correspondeert met het weeknummer voor de gegeven timestamp.)
%W - week nummer van het huidige jaar als decimaal nummer, startend met de eerste maandag als de eerste dag van de eerste week
%w - dag van de week als decimaal, waarbij zondag 0 is
%x - geprefereerde date representatie voor de huidige locale zonder de time
%X - geprefereerde time representatie voor de huidige locale zonder de date
%y - jaar als decimaal nummer zonder een eeuw (range 00 to 99)
%Y - jaar als decimaal nummer inclusief de eeuw
%Z - time zone of naam of afkorting
%% - een literal `%' karakter

Note: Niet alle conversie specifiers worden per se ondersteund door je C library, in die situatie zullen ze niet ondersteund worden door PHP's strftime(). Dit houdt in dat bijvoorbeeld %e, %T en %D (en misschien nog wel meer) niet werken op Windows.

Example#1 strftime() voorbeeld


setlocale (LC_TIME, "C");
print (strftime ("%A in het Fins is "));
setlocale (LC_TIME, "fi_FI");
print (strftime ("%A, in het Frans "));
setlocale (LC_TIME, "fr_FR");
print (strftime ("%A en in het Duits "));
setlocale (LC_TIME, "de_DE");
print (strftime ("%A.\n"));

Dit voorbeeld werkt als je de respectievelijke locales hebt geinstalleerd op je systeem.

Zie ook setlocale() en mktime() en de » Open Group specificatie van strftime().

strptime

mktime

Last updated: Sun, 25 Nov 2007

add a note User Contributed Notes
strftime

jjarsater at gmail dot com
20-May-2009 02: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.
18-May-2009 10: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 10: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 06: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 02:24


for Arabic





<?php


setlocale(LC_ALL,'ar');


echo strftime('%A %d %B %Y');


?>

eljaunis at gmail dot com
22-Oct-2008 10: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 03: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 03: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 08: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 01: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 12: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 12: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 05: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 08: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 01: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 01: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 06: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 01: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
22-Jul-1999 10: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"));


?>

add a note

strptime

mktime

Last updated: Sun, 25 Nov 2007