The DateTimeImmutable class

(PHP 5 >= 5.5.0, PHP 7)

简介

This class behaves the same as DateTime except it never modifies itself but returns a new object instead.

类摘要

DateTimeImmutable implements DateTimeInterface {

/* 继承的常量 */

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

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

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

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

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

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

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

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

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

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

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

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

/* 方法 */

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

public add ( DateInterval $interval ) : DateTimeImmutable

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

public static createFromMutable ( DateTime $datetime ) : DateTimeImmutable

public static getLastErrors ( void ) : array

public modify ( string $modify ) : DateTimeImmutable

public static __set_state ( array $array ) : DateTimeImmutable

public setDate ( int $year , int $month , int $day ) : DateTimeImmutable

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

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

public setTimestamp ( int $unixtimestamp ) : DateTimeImmutable

public setTimezone ( DateTimeZone $timezone ) : DateTimeImmutable

public sub ( DateInterval $interval ) : DateTimeImmutable

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

public format ( string $format ) : string

public getOffset ( void ) : int

public getTimestamp ( void ) : int

public getTimezone ( void ) : DateTimeZone

public __wakeup ( void )

}

DateTimeImmutable::add — Adds an amount of days, months, years, hours, minutes and seconds
DateTimeImmutable::__construct — Returns new DateTimeImmutable object
DateTimeImmutable::createFromFormat — Parses a time string according to a specified format
DateTimeImmutable::createFromMutable — Returns new DateTimeImmutable object encapsulating the given DateTime object
DateTimeImmutable::getLastErrors — Returns the warnings and errors
DateTimeImmutable::modify — Creates a new object with modified timestamp
DateTimeImmutable::__set_state — The __set_state handler
DateTimeImmutable::setDate — Sets the date
DateTimeImmutable::setISODate — Sets the ISO date
DateTimeImmutable::setTime — Sets the time
DateTimeImmutable::setTimestamp — Sets the date and time based on a Unix timestamp
DateTimeImmutable::setTimezone — Sets the time zone
DateTimeImmutable::sub — Subtracts an amount of days, months, years, hours, minutes and seconds

User Contributed Notes

katsarov at gmail dot com 05-Apr-2019 02:35


Note: If you are trying to get 02.29 for non leap year it will return 03.01

Example: 

<?php 

new DateTimeImmutable('2017-02-29') // 2017-03-01

?>

soullinker0 googlemail 24-Jan-2019 12:27


class MyDateTime extends DateTimeImmutable

{

    public function addDay(int $amount): MyDateTime

    {

        return $this->add(new DateInterval("P" . $amount . "D"));

    }

}



addDay will return DateTimeImmutable not MyDateTime. It looks like there is no "return static;"

i wish i would be

taoufik dot oussama at gmail dot com 04-Dec-2017 10:02


Here's a simple example on how this class works :



    // Create a DateTimeImmutable Object

    $date = new DateTimeImmutable('2000-01-01');

    // "Change" that object and assign it's value to a new variable

    $date2 = $date->add(new DateInterval('P6M5DT24H'));

    // Check out the content of the two variables

    echo $date->format('Y-m-d') . "\n";

    // 2000-01-01

    echo $date2->format('Y-m-d') . "\n";

    // 2000-07-07

The DateTimeImmutable class

简介

类摘要

Table of Contents

User Contributed Notes