La classe DateTime

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

Introduction

Représentation de la date et du temps.

Cette classe se comporte comme DateTimeImmutable, à l'exception que les objets se modifient eux-mêmes quand une méthode de modification telle que DateTime::modify() est appelée.

Avertissement

L'appel de méthodes sur des objets de la classe DateTime modifiera les informations encapsulées dans ces objets, si vous voulez éviter cela, vous devrez utiliser l'opérateur clone pour créer un nouvel objet. L'utilisation de DateTimeImmutable au lieu de DateTime est recommandée pour obtenir ce comportement par défaut.

Synopsis de la classe

classDateTimeimplementsDateTimeInterface {

publicconststringDateTimeInterface::ATOM = "Y-m-d\\TH:i:sP";

publicconststringDateTimeInterface::COOKIE = "l, d-M-Y H:i:s T";

publicconststringDateTimeInterface::ISO8601 = "Y-m-d\\TH:i:sO";

publicconststringDateTimeInterface::ISO8601_EXPANDED = "X-m-d\\TH:i:sP";

publicconststringDateTimeInterface::RFC822 = "D, d M y H:i:s O";

publicconststringDateTimeInterface::RFC850 = "l, d-M-y H:i:s T";

publicconststringDateTimeInterface::RFC1036 = "D, d M y H:i:s O";

publicconststringDateTimeInterface::RFC1123 = "D, d M Y H:i:s O";

publicconststringDateTimeInterface::RFC7231 = "D, d M Y H:i:s \\G\\M\\T";

publicconststringDateTimeInterface::RFC2822 = "D, d M Y H:i:s O";

publicconststringDateTimeInterface::RFC3339 = "Y-m-d\\TH:i:sP";

publicconststringDateTimeInterface::RFC3339_EXTENDED = "Y-m-d\\TH:i:s.vP";

publicconststringDateTimeInterface::RSS = "D, d M Y H:i:s O";

publicconststringDateTimeInterface::W3C = "Y-m-d\\TH:i:sP";

public__construct(string$datetime = "now", ?DateTimeZone$timezone = null)

publicadd(DateInterval$interval): DateTime

publicstaticcreateFromFormat(string$format, string$datetime, ?DateTimeZone$timezone = null): DateTime|false

publicstaticcreateFromImmutable(DateTimeImmutable$object): static

publicstaticcreateFromInterface(DateTimeInterface$object): DateTime

publicmodify(string$modifier): DateTime|false

publicstatic__set_state(array$array): DateTime

publicsetDate(int$year, int$month, int$day): DateTime

publicsetISODate(int$year, int$week, int$dayOfWeek = 1): DateTime

publicsetTime(
    int$hour,
    int$minute,
    int$second = 0,
    int$microsecond = 0
): DateTime

publicsetTimestamp(int$timestamp): DateTime

publicsetTimezone(DateTimeZone$timezone): DateTime

publicsub(DateInterval$interval): DateTime

publicdiff(DateTimeInterface$targetObject, bool$absolute = false): DateInterval

publicformat(string$format): string

publicgetOffset(): int

publicgetTimestamp(): int

publicgetTimezone(): DateTimeZone|false

public__wakeup(): void

}

Historique

Version	Description
7.2.0	Les constantes de classe de DateTime sont maintenant définies sur DateTimeInterface.
7.1.0	Le constructeur de DateTime inclut désormais les microsecondes actuelles dans la valeur construite. Avant cela, il initialisait toujours les microsecondes à `0`.

Sommaire

DateTime::add — Modifie un objet un objet DateTime, avec le nombre de jours, mois, années, heures, minutes et secondes ajouté
DateTime::__construct — Retourne un nouvel objet DateTime
DateTime::createFromFormat — Analyse une heure au format texte selon le format spécifié.
DateTime::createFromImmutable — Retourne une nouvelle instance d'objet DateTime encapsulant l'objet DateTimeImmutable fourni
DateTime::createFromInterface — Retourne un nouvel objet DateTime encapsulant l'objet DateTimeInterface fourni
DateTime::getLastErrors — Alias de DateTimeImmutable::getLastErrors
DateTime::modify — Modifie le timestamp
DateTime::__set_state — Le gestionnaire __set_state
DateTime::setDate — Assigne la date
DateTime::setISODate — Configure une date ISO
DateTime::setTime — Assigne l'heure
DateTime::setTimestamp — Assigne la date et l'heure à l'aide d'un horodatage Unix
DateTime::setTimezone — Configure le fuseau horaire de l'objet DateTime
DateTime::sub — Soustrait une durée à un objet DateTime