La classe DateTime

(PHP 5 >= 5.2.0, PHP 7)

Introduction

Table des matières

Représentation d'une date et heure.

Synopsis de la classe

DateTime implements DateTimeInterface {

/* Constantes */

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

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

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

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

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

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

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

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

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

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

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

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

/* Méthodes */

public __construct ([ string $time = "now" [, DateTimeZone $timezone = NULL ]] )

public DateTime add ( DateInterval $interval )

public static DateTime createFromFormat ( string $format , string $time [, DateTimeZone $timezone ] )

public static array getLastErrors ( void )

public DateTime modify ( string $modify )

public static DateTime __set_state ( array $array )

public DateTime setDate ( int $year , int $month , int $day )

public DateTime setISODate ( int $year , int $week [, int $day = 1 ] )

public DateTime setTime ( int $hour , int $minute [, int $second = 0 [, int $microseconds = 0 ]] )

public DateTime setTimestamp ( int $unixtimestamp )

public DateTime setTimezone ( DateTimeZone $timezone )

public DateTime sub ( DateInterval $interval )

public DateInterval diff ( DateTimeInterface $datetime2 [, bool $absolute = FALSE ] )

public string format ( string $format )

public int getOffset ( void )

public int getTimestamp ( void )

public DateTimeZone getTimezone ( void )

public __wakeup ( void )

}

Constantes pré-définies

DateTime::ATOM
DATE_ATOM: Atom (exemple : 2005-08-15T15:52:01+00:00)
DateTime::COOKIE
DATE_COOKIE: Cookies HTTP (exemple : Monday, 15-Aug-2005 15:52:01 UTC)
DateTime::ISO8601
DATE_ISO8601: ISO-8601 (exemple : 2005-08-15T15:52:01+0000)
Note: Ce format n'est pas compatible avec la norme ISO-8601, mais elle est gardée pour des raisons de compatibilité. Utilisez plutot DateTime::ATOM ou DATE_ATOM.
DateTime::RFC822
DATE_RFC822: RFC 822 (exemple : Mon, 15 Aug 05 15:52:01 +0000)
DateTime::RFC850
DATE_RFC850: RFC 850 (exemple : Monday, 15-Aug-05 15:52:01 UTC)
DateTime::RFC1036
DATE_RFC1036: RFC 1036 (exemple : Mon, 15 Aug 05 15:52:01 +0000)
DateTime::RFC1123
DATE_RFC1123: RFC 1123 (exemple : Mon, 15 Aug 2005 15:52:01 +0000)
DateTime::RFC2822
DATE_RFC2822: RFC 2822 (exemple : Mon, 15 Aug 2005 15:52:01 +0000)
DateTime::RFC3339
DATE_RFC3339: Identique à DATE_ATOM (Depuis PHP 5.1.3)
DateTime::RFC3339_EXTENDED
DATE_RFC3339_EXTENDED: RFC 3339 EXTENDED format (depuis PHP 7.0.0) (exemple: 2005-08-15T15:52:01.000+00:00)
DateTime::RSS
DATE_RSS: RSS (exemple : Mon, 15 Aug 2005 15:52:01 +0000)
DateTime::W3C
DATE_W3C: World Wide Web Consortium (exemple : 2005-08-15T15:52:01+00:00)

Historique

Version	Description
7.0.0	Constantes ajoutées : DATE_RFC3339_EXTENDED et DateTime::RFC3339_EXTENDED.
5.5.0	La classe implémente désormais DateTimeInterface.
5.4.24	La constante COOKIE a été modifiée pour se conformer à la RFC 1036, utilisant 4 digits pour l'année plutôt que 2 (RFC 850) comme c'était le cas dans les versions précédentes.
5.2.2	La comparaison d'objet DateTime avec les opérateurs de comparaison fonctionne maintenant normalement. Dans les versions antérieures, tous les objets DateTime étaient considérés comme égaux (en utilisant ==).

Sommaire

DateTime::add — Ajoute une durée à un objet DateTime
DateTime::__construct — Retourne un nouvel objet DateTime
DateTime::createFromFormat — Analyse une heure au format texte selon le format spécifié.
DateTime::getLastErrors — Retourne les dernières erreurs et alertes
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 timestamp Unix
DateTime::setTimezone — Configure le fuseau horaire de l'objet DateTime
DateTime::sub — Soustrait une durée à un objet DateTime

Rechercher une fonction PHP

Version en cache

05/11/2024 16:34:23 Cette version de la page est en cache (à la date du 05/11/2024 16:34:23) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-class.datetime.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut