DateTime::add

Others

Last updated: Fri, 12 Mar 2010

The DateTime class

Introduction

Representation of date and time.

Class synopsis

DateTime

DateTime {

/* Constants */

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

const string DateTime::COOKIE = l, d-M-y H:i:s T ;

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

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

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

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

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

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

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

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

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

/* Methods */

public DateTime add ( DateInterval $interval )

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

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

public DateInterval diff ( DateTime $datetime [, bool $absolute = false ] )

public string format ( string $format )

public static array getLastErrors ( void )

public int getOffset ( void )

public int getTimestamp ( void )

public DateTimeZone getTimezone ( 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 ] )

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

public DateTime setTimestamp ( int $unixtimestamp )

public DateTime setTimezone ( DateTimeZone $timezone )

public DateTime sub ( DateInterval $interval )

public DateTime __wakeup ( void )

}

Predefined Constants

DateTime Node Types

DateTime::ATOM
DATE_ATOM: Atom (example: 2005-08-15T15:52:01+00:00)
DateTime::COOKIE
DATE_COOKIE: HTTP Cookies (example: Monday, 15-Aug-05 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 (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 (Mon, 15 Aug 2005 15:52:01 +0000)
DateTime::W3C
DATE_W3C: World Wide Web Consortium (example: 2005-08-15T15:52:01+00:00)

DateTime::add — Adds an amount of days, months, years, hours, minutes and seconds to a DateTime object
DateTime::__construct — Returns new DateTime object
DateTime::createFromFormat — Returns new DateTime object formatted according to the specified format
DateTime::diff — Returns the difference between two DateTime objects
DateTime::format — Returns date formatted according to given format
DateTime::getLastErrors — Returns the warnings and errors
DateTime::getOffset — Returns the timezone offset
DateTime::getTimestamp — Gets the Unix timestamp
DateTime::getTimezone — Return time zone relative to given DateTime
DateTime::modify — Alters the timestamp
DateTime::__set_state — The __set_state handler
DateTime::setDate — Sets the date
DateTime::setISODate — Sets the ISO date
DateTime::setTime — Sets the time
DateTime::setTimestamp — Sets the date and time based on an Unix timestamp
DateTime::setTimezone — Sets the time zone for the DateTime object
DateTime::sub — Subtracts an amount of days, months, years, hours, minutes and seconds from a DateTime object
DateTime::__wakeup — The __wakeup handler

add a note User Contributed Notes
DateTime

gmblar+php at gmail dot com
24-Jan-2010 05:53


Small but powerful extension to DateTime



<?php



class Blar_DateTime extends DateTime {



    /**

     * Return Date in ISO8601 format

     *

     * @return String

     */

    public function __toString() {

        return $this->format('Y-m-d H:i');

    }



    /**

     * Return difference between $this and $now

     *

     * @param Datetime|String $now

     * @return DateInterval

     */

    public function diff($now = 'NOW') {

        if(!($now instanceOf DateTime)) {

            $now = new DateTime($now);

        }

        return parent::diff($now);

    }



    /**

     * Return Age in Years

     *

     * @param Datetime|String $now

     * @return Integer

     */

    public function getAge($now = 'NOW') {

        return $this->diff($now)->format('%y');

    }



}



?>



Usage:



<?php



$birthday = new Blar_DateTime('1879-03-14');



// Example 1

echo $birthday;

// Result: 1879-03-14 00:00



// Example 2

echo '<p>Albert Einstein would now be ', $birthday->getAge(), ' years old.</p>';

// Result: <p>Albert Einstein would now be 130 years old.</p>



// Example 3

echo '<p>Albert Einstein would now be ', $birthday->diff()->format('%y Years, %m Months, %d Days'), ' old.</p>';

// Result: <p>Albert Einstein would now be 130 Years, 10 Months, 10 Days old.</p>



// Example 4

echo '<p>Albert Einstein was on 2010-10-10 ', $birthday->getAge('2010-10-10'), ' years old.</p>';

// Result: <p>Albert Einstein was on 2010-10-10 131 years old.</p>



?>

tom at r dot je
10-Jun-2009 05:00


If you're stuck on a PHP 5.1 system (unfortunately one of my clients is on a rather horrible webhost who claims they cannot upgrade php) you can use this as a quick workaround:



<?php

if (!class_exists('DateTime')) {

class DateTime {

    public $date;

    

    public function __construct($date) {

        $this->date = strtotime($date);

    }

    

    public function setTimeZone($timezone) {

        return;

    }

    

    private function __getDate() {

        return date(DATE_ATOM, $this->date);    

    }

    

    public function modify($multiplier) {

        $this->date = strtotime($this->__getDate() . ' ' . $multiplier);

    }

    

    public function format($format) {

        return date($format, $this->date);

    }

}

}

?>



it is NOT perfect. Timezones and DST are not supported, but if you just need compatible basic functions this works. Feel free to complete this so it's compatible with the 5.2 datetime object.

add a note