The DateTime class

(PHP 5 >= 5.2.0)

Introduction

Representation of date and time.

Class synopsis

DateTime implements DateTimeInterface {

/* Constants */

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 RSS = "D, d M Y H:i:s O" ;

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

/* Methods */

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 ] )

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 )

}

Predefined Constants

DateTime::ATOM

DATE_ATOM

Atom (example: 2005-08-15T15:52:01+00:00)

DateTime::COOKIE

DATE_COOKIE

HTTP Cookies (example: Monday, 15-Aug-2005 15:52:01 UTC)

DateTime::ISO8601

DATE_ISO8601

ISO-8601 (example: 2005-08-15T15:52:01+0000)

DateTime::RFC822

DATE_RFC822

RFC 822 (example: Mon, 15 Aug 05 15:52:01 +0000)

DateTime::RFC850

DATE_RFC850

RFC 850 (example: Monday, 15-Aug-05 15:52:01 UTC)

DateTime::RFC1036

DATE_RFC1036

RFC 1036 (example: Mon, 15 Aug 05 15:52:01 +0000)

DateTime::RFC1123

DATE_RFC1123

RFC 1123 (example: Mon, 15 Aug 2005 15:52:01 +0000)

DateTime::RFC2822

DATE_RFC2822

RFC 2822 (example: Mon, 15 Aug 2005 15:52:01 +0000)

DateTime::RFC3339

DATE_RFC3339

Same as DATE_ATOM (since PHP 5.1.3)

DateTime::RSS

DATE_RSS

RSS (example: Mon, 15 Aug 2005 15:52:01 +0000)

DateTime::W3C

DATE_W3C

World Wide Web Consortium (example: 2005-08-15T15:52:01+00:00)

Changelog

Version	Description
5.5.0	The class now implements DateTimeInterface.
5.4.24	The COOKIE constant was changed to reflect RFC 1036 using a four digit year rather than a two digit year (RFC 850) as prior versions.
5.2.2	DateTime object comparison with the comparison operators changed to work as expected. Previously, all DateTime objects were considered equal (using ==).