DateTimeImmutable::__construct
date_create_immutable
Retourne un nouvel objet DateTimeImmutable
&reftitle.description;
&style.oop;
public DateTimeImmutable::__construct
stringdatetime"now"
DateTimeZonenulltimezone&null;
&style.procedural;
DateTimeImmutablefalsedate_create_immutable
stringdatetime"now"
DateTimeZonenulltimezone&null;
Retourne un nouvel objet DateTimeImmutable.
&reftitle.parameters;
datetime
&date.formats.parameter;
Passer "now" pour obtenir le temps courant lors de
l'utilisation du paramètre $timezone.
timezone
Un objet DateTimeZone représentant le fuseau
horaire de $datetime.
Si $timezone est omis ou &null;,
le fuseau horaire actuel sera utilisé.
Le paramètre $timezone et le fuseau horaire
actuel sont ignorés quand le paramètre $datetime
est un horodatage UNIX (p. ex. @946684800) ou spécifie
un fuseau horaire (p. ex. 2010-01-28T15:00:00+02:00 ou
2010-07-05T06:00:00Z).
&reftitle.returnvalues;
Retourne une nouvelle instance DateTimeImmutable.
&reftitle.errors;
Si une chaîne de date ou de temps invalide est fournie, une
DateMalformedStringException est lancée.
Antérieur à PHP 8.3, ceci était une Exception.
&reftitle.changelog;
&Version;
&Description;
8.3.0
Lance désormais une
DateMalformedStringException
si une chaîne invalide est fournie,
au lieu de Exception.
7.1.0
Désormais les microsecondes sont remplis avec leur valeur actuelle. Et non '00000'.
&reftitle.examples;
Exemple de DateTimeImmutable::__construct
&style.oop;
getMessage();
exit(1);
}
echo $date->format('Y-m-d');
]]>
&example.outputs;
&style.procedural;
&example.outputs;
Subtilités de DateTimeImmutable::__construct
format('Y-m-d H:i:sP') . "\n";
// date/time spécifié dans le fuseau horaire spécifié.
$date = new DateTimeImmutable('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// date/time courant dans le fuseau horaire de votre ordinateur.
$date = new DateTimeImmutable();
echo $date->format('Y-m-d H:i:sP') . "\n";
// date/time courante dans le fuseau horaire spécifié.
$date = new DateTimeImmutable('now', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// Utilisant un horodatage UNIX. Notez que le résultat est dans le fuseau horaire UTC.
$date = new DateTimeImmutable('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";
// Valeurs inexistantes sont reportées.
$date = new DateTimeImmutable('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
]]>
&example.outputs.similar;
Les dates reportées peuvent être détectées en vérifiant les avertissements à l'aide de
DateTimeImmutable::getLastErrors.
Changement du fuseau horaire associé
setTimezone($timeZone);
echo $time->format('Y/m/d H:i:s e'), "\n";
]]>
&example.outputs.similar;
Utilisation d'une chaîne de date/heure relative
format('Y/m/d H:i:s'), "\n";
]]>
&example.outputs.similar;