Is a DateTime
object not bound by its timestamp? Or does getTimestamp() has some kind of side-effect when used on DST change?
Details
When setting the timestamp of a DateTime
object which is on DST
(meaning the formatted time exists both before/after changing the clock) the returned timestamp differs from the set timestamp.
$ php --version
PHP 7.1.3 (cli) (built: Mar 17 2017 16:59:59) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies
Reproduce
Consider the following php
script:
date_default_timezone_set('Europe/Berlin');
$date = new DateTime();
$set_timestamp = 1319932800;
$date->setTimestamp($set_timestamp);
$get_timestamp = $date->getTimestamp();
fwrite(STDERR, $set_timestamp . "\n"); // 1319932800
fwrite(STDERR, $get_timestamp . "\n"); // 1319936400 **(WHY IS THIS DIFFERENT?)**
Why are the printed values not equal?
\DateTime
object doesn't keep timestamps but local time, and do conversions in timestamp getter and timestamp setter.It results with a side-effect once a year when DST is being switched off, since both timestamp ranges 1319932800..1319936400 and 1319936400..1319940000 resolve to the same local time:
https://www.epochconverter.com/timezones?q=1319936399&tz=Europe%2FBerlin https://www.epochconverter.com/timezones?q=1319939999&tz=Europe%2FBerlin
First of all, the unix timestamp is always in UTC, so it hasn't timezone and DST.
In other hand, the
DateTime
object stores local time only (the "local" means what timezone is set in theDateTime
instance).Therefore you should set timezone to +00:00 or UTC before you set a timestamp for avoid unnecessary time conversions and DST guessing.
You have two choices:
1. Set timestamp via constructor of
DateTime
The constructor will overrides the default timezone and explicit set to +00:00 when it got timestamp (started with
@
) in first parameter:Info: in this case, the timezone parameter of constructor always will be overridden.
2. Set timezone before call
setTimestamp()
Call
setTimezone()
withDateTimeZone('+00:00')
orDateTimeZone('UTC')
timezone before you callsetTimestamp()
:Notes
Of course, both of these cases the output will be:
The
date_default_timezone_set()
is unnecessary in these cases, because you don't want to do anything with local time.However when you want to print the
$date
in human readable format (so when you convert the unix timestamp to local time) the timezone will be interesting again.