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

The DateTime class

Guide Edit on GitHub ✎

Representation of date and time.

Intro

Representation of date and time.

This class behaves the same as DateTimeImmutable, except objects are modified itself when modification methods such as DateTime::modify() are called.

Warning

Calling methods on objects of the class DateTime will change the information encapsulated in these objects, if you want to prevent that you will have to use clone operator to create a new object. Use DateTimeImmutable instead of DateTime to obtain this recommended behaviour by default.

Class synopsis

class DateTime implements DateTimeInterface { }

Changelog

VersionDescription
8.4.0The class constants are now typed.
7.2.0The class constants of DateTime are now defined on DateTimeInterface.
7.1.0The DateTime constructor now includes the current microseconds in the constructed value. Before this, it would always initialise the microseconds to 0.

Datetime

In this section

DateTime::__construct

Returns new DateTime object

DateTime::__set_state

The __set_state handler

DateTime::add

Modifies a DateTime object, with added amount of days, months, years, hours, minutes and s...

DateTime::createFromFormat

Parses a time string according to a specified format

DateTime::createFromImmutable

Returns new DateTime instance encapsulating the given DateTimeImmutable object

DateTime::createFromInterface

Returns new DateTime object encapsulating the given DateTimeInterface object

DateTime::createFromTimestamp

Creates an instance from a Unix timestamp

DateTime::getLastErrors

Alias DateTimeImmutable::getLastErrors

DateTime::modify

Alters the timestamp

DateTime::setDate

Sets the date

DateTime::setISODate

Sets the ISO date

DateTime::setMicrosecond

Sets microsecond part of the time

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 obj...

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