DateTime::add
The theoretical limits of the date range seem to be "-9999-01-01" through "9999-12-31" (PHP 5.2.9 on Windows Vista 64):
<?php
$d = new DateTime("9999-12-31");
$d->format("Y-m-d"); // "9999-12-31"
$d = new DateTime("0000-12-31");
$d->format("Y-m-d"); // "0000-12-31"
$d = new DateTime("-9999-12-31");
$d->format("Y-m-d"); // "-9999-12-31"
?>
Dates above 10000 and below -10000 do not throw errors but produce weird results:
<?php
$d = new DateTime("10019-01-01");
$d->format("Y-m-d"); // "2009-01-01"
$d = new DateTime("10009-01-01");
$d->format("Y-m-d"); // "2009-01-01"
$d = new DateTime("-10019-01-01");
$d->format("Y-m-d"); // "2009-01-01"
?>
DateTime::__construct
date_create
(PHP 5 >= 5.2.0)
DateTime::__construct -- date_create — Retourne un nouvel objet DateTime
Liste de paramètres
-
time -
Une chaîne date/heure. Les formats valides sont expliqués dans la documentation sur les formats Date et Heure.
Passez
NULLici pour obtenir le temps courant en utilisant le paramètre$timezone. -
timezone -
Un objet DateTimeZone representant le fuseau horaire de
$time.Si
$timezoneest omis, le fuseau horaire actuel sera utilisé.Note:
Le paramètre
$timezoneet le fuseau horaire actuels sont ignorés lorsque paramètre$timeest un timestamp UNIX (e.g. @946684800) ou précise un fuseau (e.g. 2010-01-28T15:00:00+02:00).
Valeurs de retour
Retourne une nouvelle instance DateTime.
Style procédural retourne FALSE en cas d'erreur.
Erreurs / Exceptions
Émet un Exception en cas d'erreur.
Historique
| Version | Description |
|---|---|
| 5.3.0 | Si une date invalide est précisée, une exception est maintenant levée. Auparavant, une erreur était émise. |
Exemples
Exemple #1 Exemple avec DateTime::__construct()
Style orienté objet
<?php
try {
$date = new DateTime('2000-01-01');
} catch (Exception $e) {
echo $e->getMessage();
exit(1);
}
echo $date->format('Y-m-d');
?>
Style procédural
<?php
$date = date_create('2000-01-01');
if (!$date) {
$e = date_get_last_errors();
foreach ($e['errors'] as $error) {
echo "$error\n";
}
exit(1);
}
echo date_format($date, 'Y-m-d');
?>
Les exemples ci-dessus vont afficher :
2000-01-01
Exemple #2 Autres exemples avec DateTime::__construct()
<?php
// date/time spécifiés dans le fuseau de votre machine
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:sP') . "\n";
// date/time dans un fuseau précis.
$date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// date/time courants dans le fuseau de votre machine
$date = new DateTime();
echo $date->format('Y-m-d H:i:sP') . "\n";
// date/time courants dans un fuseau précis.
$date = new DateTime(null, new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// Utilisation d'un timestamp Unix. Notez que le résultat est dans le fuseau UTC.
$date = new DateTime('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";
// Valeur non existante
$date = new DateTime('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
2000-01-01 00:00:00-05:00 2000-01-01 00:00:00+12:00 2010-04-24 10:24:16-04:00 2010-04-25 02:24:16+12:00 2000-01-01 00:00:00+00:00 2000-03-01 00:00:00-05:00
Voir aussi
- DateTime::createFromFormat() - Retourne un nouvel objet DateTime formaté
- DateTimeZone::__construct() - Crée un nouvel objet DateTimeZone
- Formats sur les dates
- Paramètre ini date.timezone
- date_default_timezone_set() - Définit le décalage horaire par défaut de toutes les fonctions date/heure
- DateTime::getLastErrors() - Retourne les dernières erreurs et alertes
- checkdate() - Valide une date grégorienne
add a note
User Contributed Notes
DateTime::__construct - [6 notes]
kendsnyder at gmail dot com ¶
3 years ago
Tim Strehle ¶
3 years ago
"The $timezone parameter and the current timezone are ignored when the $time parameter […] is a UNIX timestamp."
Watch out – this means that these two are NOT equivalent, they result in different timezones (unless your current timezone is GMT):
<?php
$d = new DateTime(); $d->setTimestamp($t);
echo $o->format('O');
// +0200
$d = new DateTime('@' . $t);
echo $o->format('O');
// +0000
?>
joel dot kallman at gmail dot com ¶
1 year ago
A definite "gotcha" (while documented) that exists in the __construct is that it ignores your timezone if the $time is a timestamp. While this may not make sense, the object does provide you with methods to work around it.
<?php
// New Timezone Object
$timezone = new DateTimeZone('America/New_York');
// New DateTime Object
$date = new DateTime('@1306123200', $timezone);
// You would expect the date to be 2011-05-23 00:00:00
// But it actually outputs 2011-05-23 04:00:00
echo $date->format('Y-m-d H:i:s');
// You can still set the timezone though like so...
$date->setTimezone($timezone);
// This will now output 2011-05-23 00:00:00
echo $date->format('Y-m-d H:i:s');
?>
kendsnyder at gmail dot com ¶
3 years ago
Also forgot to mention, that MySQL "zeroed" dates do not throw an error but produce a non-sensical date:
<?php
$d = new DateTime("0000-00-00");
$d->format("Y-m-d"); // "-0001-11-30"
?>
Another good reason to write your own class that extends from DateTime.
cHao ¶
1 year ago
There's a reason for ignoring the time zone when you pass a timestamp to __construct. That is, UNIX timestamps are by definition based on UTC. @1234567890 represents the same date/time regardless of time zone. So there's no need for a time zone at all.
sebi at timewaster dot de ¶
1 year ago
Note that although a milliseconds portion in ISO8601 timestamps is legal, PHP cannot parse them and will throw an exception. No parser in PHP can parse it.