php8.5
/
Download
Home/ Manual/ reference / datetime/ The DateTimeImmutable class

The DateTimeImmutable class

Guide Edit on GitHub ✎

Representation of date and time.

Intro

Representation of date and time.

This class behaves the same as DateTime except new objects are returned when modification methods such as DateTime::modify() are called.

Class synopsis

class DateTimeImmutable implements DateTimeInterface { }

Changelog

VersionDescription
8.4.0The class constants are now typed.
7.1.0The DateTimeImmutable constructor now includes the current microseconds in the constructed value. Before this, it would always initialise the microseconds to 0.

Datetimeimmutable

In this section

DateTimeImmutable::__construct

Returns new DateTimeImmutable object

DateTimeImmutable::__set_state

The __set_state handler

DateTimeImmutable::add

Returns a new object, with added amount of days, months, years, hours, minutes and seconds

DateTimeImmutable::createFromFormat

Parses a time string according to a specified format

DateTimeImmutable::createFromInterface

Returns new DateTimeImmutable object encapsulating the given DateTimeInterface object

DateTimeImmutable::createFromMutable

Returns new DateTimeImmutable instance encapsulating the given DateTime object

DateTimeImmutable::createFromTimestamp

Creates an instance from a Unix timestamp

DateTimeImmutable::getLastErrors

Returns the warnings and errors

DateTimeImmutable::modify

Creates a new object with modified timestamp

DateTimeImmutable::setDate

Sets the date

DateTimeImmutable::setISODate

Sets the ISO date

DateTimeImmutable::setMicrosecond

Sets microsecond part of the time

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

Source: reference/datetime/datetimeimmutable.xml · from the official PHP manual (php/doc-en)