Here are some little tricks that might be useful to you if you’re working with dates and times in PHP:
- A "Unix timestamp" or "epoch" refers to the number of seconds since 1970-01-01 00:00:00 UTC. (i.e. a point in time in one specific timezone.) A Unix timestamp is never timezone-specific; if you call
time()at the same moment on computers in different time zones, you get exactly the same value back. mktime/gmmktime– Passed a number of arguments (day, month, year, etc.), returns a Unix timestamp.mktimeinterprets its arguments as representing a local time, whilstgmmktimeinterprets its arguments as a time in the time zone UTC. (That is, given the same inputgmmktimereturns the same results everywhere;mktimereturns timezone-specific results.) Note that in this case, thegm-prefix affects how the input is interpreted.strftime/gmstrftime– Passed a Unix timestamp and format string, and returns a string. Instrftime's case, the string is the time according to the current timezone, whilstgmstrftimereturns the time in the UTC timezone. (Given the same input,gmstrftimereturns the same time in all timezones (though not necessarily the same string–the actual string may be different if the locale is different) whilststrftimereturns timezone-specific results.) Note that in this case, thegm-prefix affects the output string.strptime– Inverse ofstrftime/gmstrftime: passed a time string and a format string, and returns an array representing the local time. (This not a great return value; it would have been better to return a Unix timestamp.) The time string is interpreted as a local time; there is nogm-equivalent, or even any way to simulate one, since it ignores the value ofdate_default_timezone_set. Note that you can impose a timezone on the input string if it contains a timezone abbreviation or offset (e.g.Sun 26 Apr 2009 21:50:35 BST) which the format string reads with%zor%Z.date/gmdate– Passed a Unix timestamp and a format string, returns a string. As withstrftime/gmstrftime, thegm-prefix affects whether the result is a representation of the time in the current timezone or in the UTC timezone. Note that the format string is completely different to that ofstrftime/gmstrftime! (One reason to use this set of functions is for the useful date format constants.) There is no inverse of this function.strtotime– Passed a string in "US English date format", and returns a Unix timestamp. Note that there is no way to override the US date format!strtotime ("03/04/2008")is the 4th of March 2008. Note that this function will parse relative times, liketomorrowandnext monday; this is about the only reason to use it.- How does PHP know what your current timezone is? It tries a few different places, including the
TZenvironment variable and thedate.timezoneini option. (Seedate_default_timezone_getfor more information.)

11 comments
11 Responses
Stay in touch with the conversation, subscribe to the RSS feed for comments on this post.
A few quick followup points to my own post:
1. If you’re using PHP 5.3, you may want to consider the DataTime module, which has been made a lot more useful in 5.3.
2. I think I’m a little unusual in my unhappiness with strtotime(); it’s a pretty easy way to parse ISO 8601 dates without having to look up format strings, for example. But even with relative dates it can return unexpected values (see Derick Rethan’s post on “next month“), so I still think it’s prudent to respect its power!
ehhm.. wouldn’t you get different values if you call time() on machines in different timezones at the same time?
hmm I guess the definition of “at the same time” is a bit fuzzy. At the same time for the specific server’s timezone or for the person calling the functions on the servers? :D
@Harro: I mean … if you have a server in the US, and one in Europe, and you call time() at the same moment in both locations, you’ll get the same value back. If you don’t do this at exactly the same moment, there might be a small difference between the servers, but the point is that you’ll never get a difference equivalent to several hours.
Neither mktime or gmmktime take an array, they take a pile of optional parameters.
@SeanJA Thanks, you’re completely correct, “array” is the wrong word. I’ve fixed the text now.
Continuing the Discussion
Tips for PHP Date and Time Functions http://bit.ly/7e689B #php #tips #phptips
Tips for PHP Date and Time Functions – http://techportal.ibuildings.com/2010/01/26/tips-for-php-date-and-time-functions/